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Introduction 


1.1 Overview 

The C language is a general-purpose programming language well known 
for its efficiency, economy, and portability. While these advantages make 
it a good choice for almost any kind of programming, C has proven to be 
especially useful in systems programming because it allows programmers 
to write fast and compact programs and to transport those programs to 
other systems. In many cases, well-written C programs are comparable in 
speed to assembly language programs and offer the advantages of easier 
maintenance and greater readability. 

In spite of C’s efficiency and power, it is a relatively small language. C does 
not include built-in functions to perform tasks such as input and output, 
storage allocation, screen manipulation, and process control. Instead, C 
programmers rely on run-time libraries to perform such tasks. 

This design contributes to C’s adaptability and compactness. Because the 
language is relatively confined, it does not assume or impose a particular 
programming model. Run-time routines provide support as needed, 
allowing the programmer to minimize their use, if desired, or to tailor run- 
time routines for special purposes. 

The design also helps to isolate language features from processor-specific 
features in a particular C implementation, thus aiding programmers who 
want to write portable code. The strict definition of the language makes it 
independent of any particular operating system or machine; at the same 
time, programmers can easily add system -specific routines to take advan- 
tage of a particular machine’s efficiencies. 

Some of the significant features of the C language are as follows: 

• C provides a full set of loop, conditional , to control program flow 
logically and efficiently and to encourage structured programming. 

• C offers an unusually large set of operators. Many of C’s operators 
correspond to common machine instructions, allowing a direct 
translation into machine code. The variety of operators lets the 
programmer specify different kinds of operations clearly and with 
a minimum of code. 

® C’s data types include several sizes of integers, single- and double- 
precision floating-point types. The programmer can design more 
complex data types, such as arrays and data structures, to suit 
specific program needs. 
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• C programmers can declare “pointers” to variables and functions. 
A pointer to an item corresponds to the machine address of that 
item. Using pointers wisely can increase program efficiency con- 
siderably, since pointers let the programmer refer to items in the 
same way the machine does. C also supports pointer arithmetic, 
allowing the programmer both to access and manipulate memory 
addresses directly. 

® The C preprocessor , a text processor, acts on the text of files before 

compilation. Among its most useful applications for C programs 
are the definition of program constants, the substitution of func- 
tion calls with faster macro look-alikes, and conditional compila- 
tion. The preprocessor is not limited to processing C files; it can be 
used on any text file. 

• C is a flexible language, leaving much of the decision-making up to 
the programmer. In keeping with this attitude, C imposes few res- 
trictions in matters such as type conversion. While this is often an 
asset, it is important for C programmers to be thoroughly familiar 
with the definition of the language in order to understand how their 
programs will behave. 


1.2 AboutThis Guide 

The XENIX C Language Reference defines the C language as implemented 
by Microsoft. It is intended as a reference for programmers who have 
experience in C or in another programming language. Knowledge of pro- 
gramming fundamentals is assumed . 

The run-time library functions available for use in Microsoft C programs 
are discussed in the XENIX C Library Guide. 

Consult the XENIX C Library Guide, for an explanation of how to compile 
and link C programs on your system. The XENIX C Library Guide, also 
contains information specific to the implementation of C on your system. 

This guide is organized as follows: 

Chapter 1, “Introduction” summarizes the organization of the guide 
and the conventions used. 

Chapter 2, “Elements of C”, describes the letters, numbers, and sym- 
bols that can be used in C programs and the combinations of charac- 
ters that have special meanings to the C compiler. 

Chapter 3, “Program Structure”, discusses the components and struc- 
ture of C programs and explains how C source files are organized. 
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Chapter 4, “Declarations”, describes how to specify the attributes of 
C variables, functions, and user-defined types. C provides a number 
of predefined data types and allows the programmer to declare aggre- 
gate types and pointers. 

Chapter 5, “Expressions and Assignments”, describes the operands 
and operators that make up C expressions and assignments. The type 
conversions and side effects that may accompany the evaluation of 
expressions are also discussed in this chapter. 

Chapter 6, “Statements”, describes C statements. Statements con- 
trol the flow of program execution . 

Chapter 7, “Functions”, discusses features of C functions. In particu- 
lar, it explains how to define, declare, and call a function and 
describes function parameters and return values. 

Chapter 8, “Preprocessor Directives”, describes the instructions 
recognized by the C preprocessor. The C preprocessor is a text pro- 
cessor automatically invoked before compilation. 

Appendix A, “Differences”, lists the differences between Microsoft 
C and the description of the C language found in Appendix A of The C 
Programming Language by Brian W. Kernighan and Dennis M. 
Ritchie, published in 1978 by Prentice-Hall, Inc. 

Appendix B, “Syntax Summary”, summarizes the syntax of the 
Microsoft C language implementation. 

The remainder of this chapter describes the notational conventions used 
throughout the guide. 


1.3 Notational Conventions 

This guide uses a number of notational conventions to describe the syntax 
of XENIX commands: 

boldface Boldface indicates a command, option, flag, or 

program name to be entered as shown. 

Boldface indicates the name of a library routine, 
global variable, standard type, constant, key- 
word, or identifier used by the C library. (To 
find more information on a given library routine 
consult the “Alphabetized List” in your XENIX 
Reference Manual for the manual page that 
describes it.) 
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italics 


CAPTIALS 

SMALL CAPITALS 

[ i 


Italics indicate a filename. This pertains to 
library include filenames (i.e. stdio.h ), as well 
as, other filenames (i.e. /etc! ttys). 

Italics indicate a placeholder for a command 
argument. When entering a command , a place- 
holder must be replaced with an appropriate 
filename, number, or option. 

Italics indicate a specific identifier, supplied for 
variables and functions, when mentioned in 
text. 

Italics indicate user named routines. (User 
named routines are followed by open and close 
parentheses, ().) 

Italics indicate emphasized words or phrases in 
text. 

Capitals indicate names of environment vari- 
ables (i.e. TZ and PATH). 

Small capitals indicate keys and key sequences 
(i.e. RETURN). 

Brackets indicate that the enclosed item is 
optional. If you do not use the optional item, 
the program selects a default action to carry out. 

Ellipses indicate that you can repeat the preced- 
ing item any numb er of times. 

Vertical ellipses indicate that a portion of a pro- 
gram example is omitted. 

Quotation marks indicate the first use of a 
technical term. 

Quotation marks indicate a reference to a word 
rather than a command. 
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2.1 Introduction 

This chapter describes the elements of the C programming language. The 
elements of the language are the names, numbers, and characters used to 
construct a C program. In particular, this chapter describes: 

• Character sets 
© Constants 

• Identifiers 

• Keywords 

• Comments 

• Tokens 


2.2 CharacterSets 

Two character sets are defined for use in C programs, the C character set 
and the representable character set. The C character set consists of the 
letters, digits, and punctuation marks that have a specific meaning to the C 
compiler. C programs are constructed by combining the characters of the 
C character set into meaningful statements. 

The C character set is a subset of the representable character set. The 
representable character set consists of all letters, digits, and symbols that a 
user can represent graphically with a single character. The extent of the 
representable character set depends on the type of terminal, console, or 
character device being used. 

A C program can contain only characters from the C character set, except 
that string literals, character constants, and comments can use any 
representable character. Each character in the C character set has an 
explicit meaning to the C compiler. The compiler generates error mes- 
sages when it encounters misused characters or characters not belonging to 
the C character set. 

The following sections describe the characters and symbols of the C char- 
acter set and explain how and when to use them. 


2.2.1 Letters and Digits 

The C character set includes the uppercase and lowercase letters of the 
English alphabet and the ten decimal digits of the Arabic number system: 
Uppercase English letters: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 
Lowercase English letters: 
abcdefghijklmnopqrstuvwxyz 
Decimal digits: 

0123456789 
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These letters and digits can be used to form the constants, identifiers, and 
keywords described later in this chapter. 

The C compiler treats uppercase and lowercase letters as distinct charac- 
ters. If a lowercase “a” is specified in a given item, you cannot substitute an 
uppercase “A ” in its place; you must use the lowercase letter. 


2.2.2 Whitespace Characters 

Space, tab, linefeed, carriage return, form feed, vertical tab, and newline 
characters are called whitespace characters because they serve the same 
purpose as the spaces between words and lines on a printed page. These 
characters separate user-defined items, such as constants and identifiers, 
from other items within a program . 

The C compiler ignores whitespace characters unless they are used as 
separators or as components of character constants or string literals. This 
means you can use extra whitespace characters to make a program more 
readable. Comments (see Section 2.6) are also treated as whitespace. 


2.2.3 Punctuation and Special Characters 

The punctuation and special characters in the C character set are used for a 
variety of purposes, from organizing the text of a program to defining the 
tasks to be carried out by the compiler or by the compiled program. Table 
2.1 lists these characters : 


Table 2.1 

Punctuation and Special Characters 


Character 

Name 

Character 

Name 

j 

Comma 

! 

Exclamation mark 


Period 

1 

Vertical bar 

> 

Semicolon 

/ 

Forward slash 

: 

Colon 

\ 

Backslash 

? 

Question mark 

~ 

Tilde 

» 

Single quotation 



Underscore 

" 

Double quotation 

# 

Number sign 

( 

Left parenthesis 

% 

Percent sign 

) 

Right parenthesis 

& 

Ampersand 

[ 

Left bracket 


Caret 

] 

Right bracket 

* 

Asterisk 

{ 

Left brace 

- 

Minus sign 
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} Right brace = Equal sign 

< Left angle bracket + Plus sign 

> Right angle bracket 


These characters have special meaning to the C compiler. Their use in the 
C language is described throughout this manual. Punctuation characters in 
the representable character set that do not appear in this list can be used 
only in string literals, character constants, and comments. 


2.2.4 Escape Sequences 

Escape sequences are special character combinations that represent whi- 
tespace and nongraphic characters in strings and character constants. 
They are typically used to specify actions such as carriage returns and tab 
movements on terminals and printers and to provide literal representa- 
tions of characters that normally have special meanings, such as the double 
quote (") character. An escape sequence consists of a backslash followed 
by a letter or combination of digits. Table 2.2 lists the C language escape 
sequences: 


Table 2.2 

Escape Sequences 


Escape Sequence 

Name 

\n 

Newline 

\t 

Horizontal tab 

\v 

Vertical tab 

\b 

Backspace 

\r 

Carriage return 

\f 

Form feed 

V 

Single quote 

V 

Double quote 

\\ 

Backslash 

\ddd 

ASCII character 
in octal notation 

\xdd 

ASCII character 
in hexadecimal notation 


If the backslash precedes a character not included in the list above, the 
backslash is ignored and that character is represented literally. For exam- 
ple, the pattern “\c” represents the character “c” in a string literal or char- 
acter constant. 
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The sequences u \ddd ” and “ \xdd ” allow any character in the ASCII char- 
acter set to be given as a three-digit octal or a two-digit hexadecimal char- 
acter code. For example, the backspace character can be given as “\010” 
or “\x08”. The A SCII null character can be given as “\0” or “\x0”. 

Only octal digits can appear in an octal escape sequence, and at least one 
digit must appear. However, fewer than three digits can be specified. For 
example, the backspace character can also be given as “MO 55 . Similarly, a 
hexadecimal escape sequence must contain at least one digit, but the 
second digit can be omitted. The hexadecimal escape sequence for the 
backspace character can be given as “\x8”. However, when using octal 
and hexadecimal escape sequences in strings, it is safer to give all three 
digits of the octal or hexadecimal escape sequence. Otherwise, the charac- 
ter following the escape sequence may be interpreted as part of the 
sequence, if it happens to be an octal or hexadecimal digit. 

Escape sequences allow nongraphic control characters to be sent to a 
display device. For example, the escape character, “\033”, is often used as 
the first character of a control command for a terminal or printer. 

Nongraphic characters should always be represented by escape sequences. 
Placing a nongraphic character in a C program has unpredictable results. 

The backslash character (\) used to introduce escape sequences also func- 
tions as a continuation character in strings and in preprocessor defi- 
nitions. When a newline character follows the backslash, the newline is 
disregarded, and the next line is treated as part of the previous line. 


2.2.5 Operators 

Operators are special character combinations that specify how values are 
to be transformed and assigned. The compiler interprets each of these 
character combinations as a single unit, called a “token” (see Section 2.7). 

Table 2.3 lists the characters that form C operators and gives the name of 
each operator. Operators must be specified exactly as they appear in the 
tables, with no whitespace between the characters of multicharacter 
operators. The sizeof operator is not included in this table; it consists of a 
keyword (sizeof) rather than a symbol. 
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Table 2.3 
Operators 


Operator 

Name 

| 

Logical NOT 


Bitwise complement 

+ 

Addition 

- 

Subtraction, arithmetic negation 

* 

Multiplication, indirection 

/ 

Division 

% 

Remainder 

<< 

Shift left 

>> 

Shift right 

< 

Less than 

<= 

Less than or equal 

> 

Greater than 

> = 

Greater than or equal 

== 

Equality 

j= 

Inequality 

& 

Bitwise AND, address-of 

j 

Bitwise inclusive OR 


Bitwise exclusive OR 

&& 

Logical AND 

II 

Logical OR 

> 

Sequential evaluation 

9 ; 

Conditional 3 

+ + 

Increment 

— 

Decrement 

= 

Simple assignment 

+= 

Addition assignment 


Subtraction assignment 

*_ 

Multiplication assignment 

/= 

Division assignment 

% = 

Remainder assignment 

>> = 

Right shift assignment 

<< = 

Left shift assignment 

&= 

Bitwise AND assignment 

h 

Bitwise inclusive OR assignment 

= 

Bitwise exclusive OR assignment 


a The conditional operator is a ternary operator, not a multicharacter operator. 
The form of a conditional expression is: expression ? expression : expression 
See Chapter 5, “Expressions and Assignments,” for a complete descrip- 
tion of each operator. 
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2.3 Constants 

A constant is a number, a character, or a string of characters that can be 
used as a value in a program. The value of a constant does not change from 
execution to execution. 

The C language has four kinds of constants: integer constants, floating- 
point constants, character constants, and string literals. The following 
sections define the format and use of each . 


2.3.1 Integer Constants 

An integer constant is a decimal, octal, or hexadecimal number that 
represents an integer value. A decimal constant has the form: 

digits 

where digits are one or more decimal digits (0 through 9). 

An octal constant has the form : 

Oo digits 

where odigits are one or more octal digits (0 through 7). The leading zero is 
required. 

A hexadecimal constant has the form : 

0 xhdigits 

where hdigits is one or more hexadecimal digits (0 through 9 and either 
uppercase or lowercase “a” through “f”). The leading zero is required and 
must be followed by “x”. 

No whitespace characters can appear between the digits of an integer con- 
stant. Table 2.4 illustrates the form of integer constants: 

Table 2.4 

IntegerConstants 


Decimal Constants 

Octal Constants 

Hexadecimal Constants 

10 

012 

OxaorOxA 

132 

0204 

0x84 

32179 

076663 

0x7dB3or0x7DB3 


Integer constants always specify positive values. If negative values are 
required, the minus sign (-) can be placed in front of the constant to form a 
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constant expression with a negative value. The minus sign is treated as an 
arithmetic operator. 

Every integer constant is given a type based on its value. A constant’s type 
determines what conversions must be performed when the constant is used 
in an expression or when the minus sign (-) is applied. Decimal constants 
are considered signed quantities and are given int type, or long type if the 
size of the value requires it. 

Octal and hexadecimal constants are also given int type, or long type if the 
size of the value requires it. However, unlike other signed numbers, octal 
and hexadecimal constants are not sign-extended in type conversions. 

The programmer can direct the C compiler to force any integer constant to 
have long type by appending the letter “1” or “L” to the end of the con- 
stant. T able 2.5 illustrates long integer constants: 

Table 2.5 

Long Integer Constants 


Decimal Constants 

Octal Constants 

Hexadecimal Constants 

10L 

012L 

OxaLorOxAL 

791 

01151 

0x4fl or 0x4Fl 


Types are described in Chapter 4, “Declarations”,” and conversions are 
described in Chapter 5, “Expressions and Assignments”.” 


2.3.2 Floating- Point Constants 

A floating-point constant is a decimal number representing a signed real 
number. The value of a signed real number includes an integer portion, a 
fractional portion, and an exponent. Floating-point constants have the 
form: 


[digits][.digits][E[-]digits] 

where digits are one or more decimal digits (0 through 9), and E (or e) is the 
exponent symbol. Either the digits before the decimal point (the integer 
portion of the value) or the digits after the decimal point (the fractional 
portion) can be omitted, but not both. The exponent consists of the 
exponent symbol followed by a possibly negative constant integer value. 
The decimal point can be omitted only when an exponent is given. No whi- 
tespace characters can separate the digits or characters of the constant. 

Floating-point constants always specify positive values. If negative values 
are required, the minus sign (-) can be placed in front of the constant to 
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form a constant floating-point expression with a negative value. The minus 
sign is treated as an arithmetic operator. 

The following examples illustrate some of the forms of floating-point con- 
stants and expressions: 

15.75 

1.575E1 

1575e-2 

-0.0025 

-2.5e-3 

25E-4 

The integer portion of the floating-point constant can be omitted, as 
shown in the following examples: 

.75 

.0075e2 

-.125 

-.175E-2 

All floating-point constants have type double. 


2.3.3 Character Constants 

A character constant is a letter, digit, punctuation character, or escape 
sequence enclosed in single quotation marks. The value of a character 
constant is the character itself. Character constants consisting of more 
than one character or escape sequence are not allowed. 

A character constant has the form: 

’ char 3 

where char can be any character from the representable character set 
(including any escape sequence) except a single quotation mark (’), a 
backslash (\), or a newline character. To use a single quotation mark or 
backslash character as a character constant, precede it with a backslash as 
shown in Table 2.6. To represent a newline character, use the escape 
sequence ’\n\ 
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Table 2.6 

Examples of Character Constants 


Constant 

Value 

V 

Lowercase a 


Question mark 

’\b’ 

Backspace 

’\xfcB’ 

ASCII escape character 


Single quotation mark 

|’\V 

Backslash 


Character constants have type char and consequently are sign-extended in 
type conversions (see Section 5.7 of Chapter 5, “Expressions and Assign- 
ments ,, ). 


2.3.4 String Literals 

A string literal is a sequence of letters, digits, and symbols enclosed in dou- 
ble quotation marks. A string literal is treated as an array of characters; 
each element of the array is a single character value. 

The form of a string literal is: 

"characters" 

where characters are one or more characters from the representable char- 
acter set, excluding the double quotation mark ("), the backslash (\), and 
the newline character. To use the newline character in a string, type a 
backslash immediately followed by a newline character. The backslash 
causes the newline character to be ignored. This allows the programmer to 
form string literals that occupy more than one line. For example, the string 
literal: 

"Long strings can be bro\ 
ken into two pieces." 

is identical to the string: 

"Long strings can be broken into two pieces." 

To use the double quotation mark or backslash character within a string 
literal, precede it with a backslash, as shown in the following examples: 
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'This is a string literal . ” 

"Enter a number between 1 and 100 \n Or press Return" 

"FirstWSecond" 

"V'Yes, I do,\" she said." 

Notice that escape sequences (such as \n and \") can appear in string 
literals. 

The characters of a string are stored in order at contiguous memory loca- 
tions. A null character (\) is automatically appended to mark the end of 
the string. Each string in a program is considered to be a distinct item. If 
two identical strings appear in a program, they each receive distinct storage 
space. 

String literals have the type char [ ]. This means a string is an array whose 
elements have type char. The number of elements in the array is the 
number of characters in the string literal plus one, since the null character 
stored after the last character counts as an array element. 


2.4 Identifiers 

Identifiers are the names you supply for the variables, functions, and labels 
used in a given program. You can create an identifier by declaring it with 
the associated variable or function. You can use the identifier in later state- 
ments within the program to refer to the given item. (Declarations are 
described in Chapter 4, “Declarations”.”) 

An identifier is a sequence of one or more letters, digits, or underscores (_) 
that begins with a letter or underscore. Any number of characters are 
allowed in a given identifier, but only the first 31 characters are significant 
to the compiler. (Other programs that read the compiler output, such as 
the linker, may use fewer characters.) Use leading underscores with care. 
Identifiers beginning with an underscore can conflict with the names of 
hidden system routines and produce errors. 

The following are examples of identifiers: 

j 

cnt 

tempi 

top_of_page 
skip 12 

The C compiler considers uppercase and lowercase letters to be separate 
and distinct characters. Thus, you can create distinct identifiers that have 
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the same spelling but different cases for one or more of the letters. For 
example, each of the following identifiers is unique: 

add 

ADD 

Add 

aDD 

The C compiler does not allow identifiers that have the same spelling and 
case as a C language keyword. Keywords are described in Section 2.5. 

The linker may further restrict the number and type of characters for glo- 
bally visible symbols. Furthermore, unlike the compiler, the linker may 
not distinguish between uppercase and lowercase letters. Consult your 
linker documentation for information on naming restrictions imposed by 
the linker. 


2.5 Keywords 

Keywords are predefined identifiers that have special meaning to the C 
compiler. They can be used only as defined. The names of program items 
may not conflict with the keywords listed below: 


auto 

default 

float 

register 

switch 

break 

do 

for 

return 

typedef 

case 

double 

goto 

short 

union 

char 

else 

if 

sizeof 

unsigned 

const 

enum 

int 

static 

void 

continue 

extern 

long 

struct 

while 


Keywords cannot be redefined. However, you can specify text to be substi- 
tuted for keywords before compilation by using C preprocessor directives 
(see Chapter 8, “Preprocessor Directives””). 

The const keyword is reserved for future use but is not yet implemented in 
the language. 

The following identifiers may be keywords in some implementations; (see 
your system documentation for details): 

far 

fortran 

huge 

near 

pascal 
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2.6 Comments 

A comment is a sequence of characters that is treated as a single white- 
space character by the compiler but is otherwise ignored. A comment has 
the following form: 

/* characters */ 

Here characters can be any combination of characters from the represent- 
able character set, including newline characters but excluding the combi- 
nation “*/”. This means that comments can occupy more than one line, 
but they cannot be nested. 

Comments are typically used to document the statements and actions of a 
C language source program. They can appear anywhere a whitespace char- 
acter is allowed. Since the compiler ignores the characters of the com- 
ment, keywords can appear in comments without producing errors. 

The following examples illustrate some comments: 

/* Comments can separate and document 
lines of a program. */ 

/* Comments can contain keywords such as for 
and while. */ 

^♦♦** ************************************* 

Comments can occupy several lines. 


Since comments cannot contain nested comments, the following example 
causes an error: 

/* You cannot /* nest */ comments */ 

The compiler recognizes the first after the word “nest”, as the end of 

the comment. The compiler attempts to process the remaining text and 
produces an error when it cannot do so . 

To suppress compilation of a large portion of a program or a program seg- 
ment that contains comments, use the #if preprocessor directive instead 
of comments (see Section 8.4 of Chapter 8, “Preprocessor Directives””). 


2.7 Tokens 

When the compiler processes a program, it breaks the program down into 
groups of characters known as “tokens.” A token is a unit of program text 
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that has meaning to the compiler and that cannot be broken down further. 
The operators, constants, identifiers, and keywords described in this 
chapter are examples of tokens. Punctuation characters such as brackets 
([ ]), braces ({ }), angle brackets (< >), parentheses, and commas are also 
tokens. 

Tokens are delimited by whitespace characters and by other tokens, such 
as operators and punctuation symbols. To prevent the compiler from 
breaking an item down into two or more tokens, whitespace characters are 
prohibited between the characters of identifiers, multicharacter operators, 
and keywords. 

When the compiler interprets tokens, it incorporates as many characters as 
possible into a single token before moving on to the next token. Because 
of this behavior, tokens not separated by whitespace may not be inter- 
preted in the way expected. 

For example, in the following expression, the compiler first makes the 
longest possible operator (++) from the three plus signs, and then 
processes the remaining plus sign as an addition operator (+): 

i+++j 

This expression is interpreted as “(i++) + (j)”, not “(i) + (++j)”. Use whi- 
tespace and parentheses to clarify your intent in such cases. 
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3.1 Introduction 

This chapter describes the structure of C language source programs and 
defines terms used later in this manual to describe the C language. It pro- 
vides an overview of C language features that are described in detail in 
other chapters. In particular, the syntax and meaning of declarations and 
definitions are discussed in Chapter 4, “Declarations”,” and Chapter 7, 
“Functions.” The C preprocessor is described in Chapter 8, “Preproces- 
sor Directives.” 


3.2 Source Program 

A C source program is a collection of one or more directives, declarations, 
and/or definitions. “Directives” instruct the C preprocessor to perform 
specific actions on the text of the program prior to compilation. “Declara- 
tions” establish the names and attributes of variables, functions, and types 
used in the program. 

“Definitions” are declarations that also define variables and functions. A 
variable definition gives the initial value of the declared variable, in addi- 
tion to its name and type. The definition causes storage to be allocated for 
the variable. A function definition specifies the function body, a com- 
pound statement containing the declarations and statements that consti- 
tute the function. The function definition also gives the function name, 
formal parameters, and return type. 

A source program can have any number of directives, declarations, and 
definitions. Each must have the appropriate syntax as described in this 
manual. They can appear in any order in the program, although the order 
affects how variables and functions can be used in the program (see Sec- 
tion 3.5). 

A nontrivial program always contains at least one definition, a function 
definition. The function defines the action to be taken by the program. 
The following example illustrates a simple C source program. 
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Example 


int x = 1; 

/* Variable definitions */ 
inty = 2; 

extern int printf (char *,); 

/* Function declaration */ 

main () 

/* Function definition for main function */ 

{ . 

intz; 

/* Variable declarations */ 
int w; 


z = y + x; 

/* Executable statements */ 
w = y-x; 

printf ("z= %d \n w= %d \n", z, w); 


This source program defines the function named main and declares the 
function printf. The variables x andy are defined with variable definitions ; 
the variables z and w are just declared. 


3.3 Source Files 

Source programs can be divided into one or more separate source files. A 
C source file is a text file that contains all or part of a C source program. It 
may, for example, contain just a few of the functions needed by the pro- 
gram. When the source program is compiled, the individual source files 
that make up the program must be compiled individually and then linked. 
Separate source files can also be combined to form larger source files 
before compilation by using the #include directive, discussed in Chapter 
8, “Preprocessor Directives.” 

A source file can contain any combination of complete directives, declara- 
tions, and definitions. Items such as function definitions or large data 
structures cannot be split between source files. 
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A source file need not contain any executable statements. It is sometimes 
useful to place variable definitions in one source file and then declare refer- 
ences to these variables in other source files that use them. This makes the 
definitions easy to find and modify if necessary. For the same reason, man- 
ifest constants and macros (discussed in chapter 8, “Preprocessor Direc- 
tives”) are often organized into separate include files and inserted into 
source files where required. 

Directives in a source file apply to that source file and its included files only. 
Moreover, each directive applies only to the portion of the file following 
the directive. If a common set of directives is to be applied to a source pro- 
gram, then all source files in the program must contain these directives. 

The following is an example of a C source program contained in two source 
files. The main() and max{) functions are assumed to be in separate files, 
and execution of the program is assumed to begin with the main{) func- 
tion. 
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Example 


/************************************************** 
Source file 1 - main function 

********************************** ** **************^ 


#define ONE 1 
#defineTWO 2 
#define THREE 3 

extern int max(int, int); 

/* Function declaration */ 

main () 

/* Function definition */ 

{ 

int w = ONE, x = TWO, y = THREE; 
intz = 0; 
z = max(x,y); 
w = max(z,w); 

> 


/************************************************** 
Source file 2 - max function 

******************************************** j^*****^ 


int max (a, b) 

/* Function definition */ 
int a, b; 

{ 

if ( a > b ) 
return (a); 
else 

return (b); 

} 

In the first source file, the function max() is declared without being 
defined. This is known as a “forward declaration”. The function 
definition for main() includes function calls to max{). 

The lines beginning with a number sign (#) are preprocessor directives. 
These directives instruct the preprocessor to replace the identifiers ONE, 
TWO, and THREE with the specified number in the first source file. The 
directives do not apply to the second source file. 

The second source file contains the function definition for max(). This 
definition satisfies the calls to max { ) in the first source file. Once the 
source files are compiled, they can be linked and executed as a single pro- 
gram. 
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3.4 Program Execution 

Every program must have a primary (main) program function. This func- 
tion serves as the starting point for program execution and usually controls 
execution of the program by directing the calls to other functions in the 
program. A program usually stops executing at the end of the main func- 
tion, although it can stop at other points in the program, depending on the 
execution environment. 

The source program usually has more than one function, each designed to 
perform one or more specific tasks. The main{) function can call these 
functions to perform the tasks. When a function is called, execution 
begins at the first statement in the called function. The function returns 
control when a return statement is executed or the end of the function is 
encountered. 

All functions, including the main() function, can be declared to have 
parameters. Functions called by other functions receive values for the 
parameters from the calling functions. Parameters of the main() function 
can be declared to receive values passed to the main function from outside 
the program (for example, from the command line when the program is 
executed). 

Traditionally, the first three parameters of the main function are declared 
to have the names argc, argv, and envp. The argc parameter is declared to 
hold the total number of arguments passed to the main function. The argv 
parameter is declared as an array of pointers, each element of which points 
to a string representation of an argument passed to the mainQ function. 
The envp parameter is a pointer to a table of string values that set up the 
environment in which the program executes. 

The operating system supplies values for the argc, argv, and envp parame- 
ters, and the user supplies the actual arguments to the main function. The 
argument-passing convention in use on a particular system is determined 
by the operating system rather than by the C language. See your system 
documentation for details. 

Formal parameters to functions must be declared when the function is 
defined. Function definitions are described in more detail in Section 7.2 of 
Chapter 7, “Functions’’. Function declarations are discussed in Section 

4.5 of Chapter 4, “Declarations”. 
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3.5 Lifetime and Visibility 

Two concepts, “lifetime” and “visibility,” are important in understanding 
the structure of a C program. The lifetime of a variable or function can be 
either “global” or “local.” An item with a global lifetime has storage and a 
defined value throughout the duration of the program. An item with a local 
lifetime is allocated new storage each time the “block” in which it is 
defined or declared is entered. When the block is exited, the local item 
loses its storage, and hence its value. Blocks are defined and discussed 
below. 

An item is said to be “visible” in a block or source file if the type and name 
of the item are known in the block or source file. An item can also be “glo- 
b ally visible,” which means that it is visible, or can be made visible through 
appropriate declarations, throughout all the source files that constitute the 
program. Visibility between source files (also known as “linkage”) is dis- 
cussed in greater detail in Section 4.6 of Chapter 4, “Declarations.” 

A block is a compound statement. Compound statements consist of 
declarations and statements, as described in Section 6.3 of Chapter 6, 
“Statements”.” The bodies of C functions are compound statements. 
Blocks can be nested; function bodies frequently contain blocks, which in 
turn can contain blocks. 

Declarations and definitions within blocks are said to occur at the “internal 
level.” Declarations and definitions outside of all blocks occur at the 
“external level.” 

Both variables and functions can be declared at the external level or at the 
internal level. Variables can also be defined at the internal level, but func- 
tions can only be defined at the external level. 

All functions have global lifetimes, regardless of where they are declared. 
Variables declared at the external level always have global lifetimes. Vari- 
ables declared at the internal level usually have local lifetimes; however, 
the storage class specifiers static and extern can be applied to declare glo- 
bal variables or references to global variables within a block. See Section 

4.6 of Chapter 4 “Declarations,” for a discussion of these options. 

Variables declared or defined at the external level are visible from the point 
at which they are declared or defined to the end of the source file. These 
variables can be made visible in other source files with appropriate 
declarations, as described in Section 4.6 of Chapter 4, “Declarations”.” 
However, variables that are given static storage class at the external level 
are visible only within the source file in which they are defined. 

In general, variables declared or defined at the internal level are visible 
from the point at which they are first declared or defined to the end of the 
block in which the definition or declaration appears. These variables are 
called local variables. If a variable declared inside a block has the same 
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name as a variable declared at the external level, the block definition super- 
sedes the external level definition of the variable for the duration of the 
block. The visibility of the external level variable is restored when the 
block is exited. 

Block visibility can nest. This means that a block nested inside another 
block can contain declarations that redefine variables declared in the outer 
block. The redefinition of the variable holds in the inner block, but the ori- 
ginal definition is restored when control returns to the outer block. Vari- 
ables from outer blocks are visible inside all inner blocks, as long as they 
are not redefined in the inner blocks. 

Functions with static storage class are visible only in the source file in 
which they are defined. All other functions are globally visible. See Sec- 
tion 4.5 of Chapter 4, “Declarations”, ” for more information on function 
declarations. 

Table 3.1 summarizes the main factors that determine the lifetime and visi- 
bility of functions and variables. The table is not, however, intended to 
cover all cases. Refer to the above discussion and to Section 4.6 of 
Chapter 4, “Declarations,” for more detailed information. 

Table 3.1 

Summary of Lifetime and Visibility 


Level 

Item 

Storage 

Class 

Specifier 

Lifetime 

Visibility 

External 

Variable 

declaration 

static 

Global 

Restricted 
to single 
source file 


Variable 

declaration 

extern 

Global 

Remainder 
of source file 


Function 
declaration 
or definition 

static 

Global 

Restricted 
to single 
source file 


Function 
declaration 
or definition 

extern 

Global 

Remainder 
of source file 

Internal 

Variable 
definition or 
declaration 

extern or 
static 

Global 

Block 


Variab le 
definition or 
declaration 

auto or 
register 

Local 

Block 


The following program example illustrates blocks, nesting, and visibility of 
variables. 
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Example 


/* i defined at external level */ 
int i = l; 

/* main function defined at external level */ 
main () 

{ 


/* prints 1 (value of external level i) */ 
printf("%d\n", i); 

/* first nested block */ 

{ 


/* i and j defined at internal level */ 
int i = 2,j = 3; 

/* prints 2, 3 */ 
printf("%d\n%d\n", i, j); 

/* second nested block */ 

{ 


/* i is redefined */ 
int i = 0; 

/* prints 0, 3 */ 
printf("%d\n%d\n", i, j); 

/* end of second nested block */ 

} 

/* prints 2 (outer definition restored) */ 
printf ("% d\n", i); 

/* end of first nested block */ 

} 

/* prints 1 

* (external level definition restored) 

*/ 

printfC'^odW, i); 

} 

In this example, there are four levels of visibility: the external level and 
three block levels. Assuming that the function printf is defined elsewhere 
in the program, the mainQ function prints out the values 1, 2, 3, 0, 3, 2, 1. 
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3.6 Naming Classes 

In any C program, identifiers are used to refer to many different kinds of 
items. When you write a C program, you provide identifiers for the func- 
tions, variables, formal parameters, union members, and other items the 
program uses. C allows you to use the same identifier for more than one 
program item, as long as you follow the rules outlined in this section. 

The compiler sets up “naming classes” to distinguish between the 
identifiers for different kinds of items. The names within each class must 
be unique to avoid conflict, but an identical name can appear in one or 
more naming classes. This means that you can use the same identifier for 
two or more different items if the items are in different naming classes. The 
context of a given identifier in the program allows the compiler to resolve 
the reference without ambiguity. 

The kinds of items you can name in C programs, and the rules for naming 
them , are describ ed b elo w : 

V ariables and Functions The names of variables and functions are in 

a naming class with formal parameters and 
enumeration constants. Variable and func- 
tion names must, therefore, be distinct 
from other names in this class with the same 
visibility. 

However, variable names can be redefined 
within program blocks, as described in Sec- 
tion 3.5. Function names can also be 
redefined in this manner. 

Formal Parameters The names of formal parameters to a func- 

tion are grouped with the names of the 
function’s variables, so the formal parame- 
ter names should be distinct from the vari- 
able names. Redeclaring formal parame- 
ters within the function causes an error. 

Enumeration Constants Enumeration constants are in the same 

naming class as variable and function 
names. This means that names of enu- 
meration constants must be distinct from 
all variable and function names with the 
same visibility and distinct from the names 
of other enumeration constants with the 
same visibility. However, like variable 
names, the names of enumeration con- 
stants have nested visibility, meaning that 
they can be redefined within blocks. See 
Section 3.5. 
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Tags 


Members 


Statement Labels 


Typedef Names 


Enumeration, structure, and union tags are 
grouped together in a single naming class. 
Each enumeration, structure, or union tag 
must be distinct from other tags with the 
same visibility. Tags do not conflict with 
any other names. 

The members of each structure and union 
form a naming class. The name of a 
member must, therefore, be unique within 
the structure or union, but it does not have 
to be distinct from any other name in the 
program. 

Statement labels form a separate naming 
class. Each statement label must be distinct 
from all other statement labels in the same 
function. Statement labels do not have to 
be distinct from any other names or from 
label names in other functions. 

The names of types defined with typedef 
are treated as keywords. No other names 
with the same visibility are allowed to have 
the same spelling and case as a typedef key- 
word. 


Example 


struct student { 
char student[20]; 
int class; 
intid; 

} student; 

Structure tags, structure members, and variable names are in three 
different naming classes, so no conflict occurs between the three items 
named student in the above example. The compiler determines how to 
interpret each occurrence of student by its context in the program. For 
example, when student appears after the struct keyword, it is known to be a 
structure tag. When student appears after either of the member selection 
operators or the name refers to the structure member. In other 

contexts, the identifier student refers to the structure variable. 
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4.1 Introduction 

This chapter describes the form and constituents of C declarations for vari- 
ables, functions, and types. C declarations have the form: 

[sc- specifier ] [type- specifier] declarator[=initializer\ [, declarator . . .] 

where sc- specifier is a storage class specifier, type- specifier is the name of a 
defined type, declarator is an identifier that can be modified to declare a 
pointer, array or function, and initializer gives a value or sequence of 
values to be assigned to the variable being declared. 

All C variables must be explicitly declared before they are used. C func- 
tions can be declared explicitly in a function declaration or implicitly by 
calling the function before it is declared or defined. 

The C language defines a standard set of data types. You can add to that set 
by declaring new data types based on types already defined. You can 
declare arrays, data structures, and pointers to both variables and func- 
tions. 

C declarations require one or more “declarators”. A declarator is an 
identifier that can be modified with brackets ([]), asterisks (*), or 
parentheses to declare an array, pointer, or function type. When you 
declare simple variables (such as character, integer, and floating-point 
values), or structures and unions of simple variables, the declarator is just 
an identifier. 

Four storage class specifiers are defined in C: auto, extern, register, and 
static. The storage class specifier of a declaration affects how the declared 
item is stored and initialized and which portions of a program can refer- 
ence it. The location of the declaration within the source program and the 
presence or absence of other declarations of the variable are also impor- 
tant factors in determining the visibility of variables. 

Although function declarations are presented in Section 4.5 of this 
chapter, function definitions are described in Section 7.2 of Chapter 7, 
“Functions”.” 


4.2 Type Specifiers 

The C language provides definitions for a set of basic data types, called the 
“fundamental” types. Their names are listed in Table 4.1. 
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Table 4.1 

Fundamental Types 


Integral Types 8 

Floating-Point 

Types 8 

Other 

char 

float 

void b 

int 

double (also called 
long float) 


short int 

long int 
unsigned char 
unsigned int 
unsigned short int 
unsigned long int 




a Used to declare variables and function return types. 
b Used only to declare function return types. 


Enumeration types are also considered fundamental types; type specifiers 
for enumeration types are discussed in Section 4.8.1. The char, int, short 
int, and long int types, together with their unsigned counterparts, are 
called “integral” types. The float and double type specifiers refer to 
“floating-point” types. 

The void type can only be used to declare functions that return no value. 
Function types are discussed in Section 4.5. 

You can create additional type specifiers with typedef declarations, dis- 
cussed in Section 4.8.2. 

Variable and function declarations can use any of the integral or floating- 
point type specifiers listed above. You can abbreviate some type 
specifiers, as shown in Table 4.2. 
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Table 4.2 

Type Specifiers and Abbreviations 

Type Specifier Abbreviation 

char 
int 

short int 
long int 
unsigned char 
unsigned int 
unsigned short int 
unsigned long int 
float 

long float 

Table 4.3 summarizes the storage associated with each fundamental type 
and gives the range of values that can be stored in a variable of each type. 
Since the void type does not apply to variables, it is not included in the 
table. 

Table 4.3 

Storage and Range of Values forFundamentalTypes 


Type 

Storage 

Range ofValues 
(Internal) 

char 

lbyte 

-128 to 127 

int 

implementation- 

dependent 


short 

2 bytes 

-32,768 to 32,767 

long 

4 bytes 

-2,147,483,648 to 2,147,483,647 

unsigned char 

lbyte 

Oto 255 

unsigned 

implementation- 

dependent 


unsigned short 

2 bytes 

Oto 65,535 

unsigned long 

4bytes 

Oto 4,294,967,295 

float 

4 bytes 

IEEE standard notation; 
see discussion below. 

double 

8 bytes 

IEEE standard notation; 
see discussion below. 


short 

long 

unsigned 

unsignedshort 

unsignedlong 

double 
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The char type is used to store a letter, digit, or symbol from the represent- 
able character set. The integer value of a character is the ASCII code 
corresponding to that character. Since the char type is interpreted as a 
signed 1-byte integer, values in the range -128 to 127 are permitted for char 
variables, although only the values from 0 to 127 have character 
equivalents. 

Notice that the storage and range associated with the int and unsigned int 
types are not defined by the C language. Instead, the size of an int (signed 
or unsigned) corresponds to the natural size of an integer on a given 
machine. For example, on a 16-bit machine the int type is usually 16 bits, 
or 2 bytes. On a 32-bit machine the int type is usually 32 bits, or 4 bytes. 
Thus, the int type is equivalent either to the short int or the long int type, 
depending on the implementation. Similarly, the unsigned int type is 
equivalent either to theunsignedshortorunsigned long type. 

The int and unsigned int type specifiers are widely used in C programs 
because they allow a particular machine to handle integer values in the 
most efficient way for that machine. However, since the size of the int and 
unsigned int types varies, programs that depend on a specific int size may 
be nonportable. Expressions involving the sizeof operator (discussed in 
Section 5.3.4 of Chapter 5, “Expressions and Assignments”) can be used 
in place of hard-coded data sizes to increase the portability of the code. 

The type specifiers int and unsigned int (or simply unsigned) are used to 
define certain features of the C language (for instance, in defining the 
enum type later in Section 4.8.1). In these cases, the definition of int and 
unsigned int for a particular implementation determines the actual 
storage. 

The range of values for a variable lists the minimum and maximum values 
that can be represented internally in a given number of bits. However, 
because of C’s conversion rules (discussed in detail in Chapter 5, “Expres- 
sions and Assignments”), it is not always possible to use the maximum or 
minimum for a variable of a given type in an expression. 

For example, the constant-expression -32,768 consists of the arithmetic 
negation operator (-) applied to the constant value 32,768. Since 32,768 is 
too large to represent as a short, it is given long type, and the constant- 
expression -32,768 consequently has long type. The value -32,768 can 
only b e represented as a s hort by type-casting it to the s hort type. No infor- 
mation is lost in the type cast, since -32,768 can be represented internally 
in 2 bytes of storage space. 

Similarly, a value such as 65,000 can only be represented as an unsigned 
short by type-casting the value to uns igned short type or by giving the value 
in octal or hexadecimal notation. The value 65,000 in decimal notation is 
considered a signed constant, and is given long type because 65,000 does 
not fit into a short. This long value can then be cast to the unsigned short 
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type without loss of information, since 65,000 will fit into 2 bytes of storage 
space when it is stored as an unsigned number. 

Octal and hexadecimal constants are considered unsigned quantities, even 
though they are given int or long type, because they have the special pro- 
perty of representing a bit pattern. Thus, octal and hexadecimal constants 
are not sign-extended in type conversions. 

Floating-point numbers use the IEEE (Institute of Electrical and Elec- 
tronics Engineers, Inc.) format. Values with float type have 4 bytes, con- 
sisting of a sign bit, a 7-bit excess 127 binary exponent, and a 24-bit 
mantissa. The mantissa represents a number between 1.0 and 2.0. Since 
the high-order bit of the mantissa is always 1, it is not stored in the number. 
This representation gives an exponent range of 10 to the (+ or -) 38th 
power and up to seven digits of precision. The maximum value of a float is 
normally 1.701411E38. 

Values with double type have 8 bytes. The format is similar to the float for- 
mat, except that the exponent is 11 bits excess 1023, and the mantissa has 
52 bits (plus the implied high-order 1 bit). This gives an exponent range of 
10 to the (+ or -) 306th power and up to 15 digits of precision. 


4.3 Declarators 


Syntax 


identifier 
declarator[ ] 

decla rator[co nsta nt- expression ] 

* declarator 
declarator ( ) 
declarator (arg- type- list ) 

(declarator) 

C allows the programmer to declare arrays of values, pointers to values, 
and function^ returning values of specified types. To declare these items, 
you must use a “declarator”. 

A declarator is an identifier possibly modified with brackets some combi- 
nation of ([ ]), parentheses, and asterisks (*) to declare an array, pointer, 
or function type. Declarators appear in the pointer, array, and function 
declarations described in later sections of this chapter (Sections 4.4.6, 
4.4.5, and 4.5, respectively). This section discusses the rules for forming 
and interpreting declarators. 
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4.3. 1 Pointer, Array, and Function Declarators 

When a declarator consists of an unmodified identifier, the item being 
declared has an unmodified type. Asterisks (*) can appear to the left of an 
identifier, modifying it to a pointer type. If the identifier is followed by 
brackets ([ ]), the type is modified to an array type. If the identifier is fol- 
lowed by parentheses, the type is modified to afunction=returning type. 

A declarator does not constitute a complete declaration; a type specifier 
must be included as well. The type specifier gives the type of the elements 
for an array type, the type of object addressed by a pointer type, and the 
return type of a function. 

The sections on pointer, array, and function declarations later in this 
chapter discuss each type of declaration in detail (see Sections 4.4.6, 4.4.5, 
and 4.5, respectively). The following examples illustrate the simplest 
forms of declarators: 


Examples 


1. intlist[20]; 

2. char*cp; 

3. double func(void); 

The above examples declare: 1. an array of int values (list); 2. a pointer to a 
char value (cp); and 3. a function with no arguments returning a double 
value (func ). 


4.3.2 Complex Declarators 

Any declarator can be enclosed in parentheses. Parentheses are typically 
used to specify a particular interpretation of a “complex” declarator, as 
discussed b elow. A *' ‘complex” declarator is an identifier qualified by more 
than one array, pointer, or function modifier. 

Various combinations of the array, pointer, and function modifiers can be 
applied to a single identifier. Some combinations are illegal. An array can- 
not be composed of functions, and a function cannot return an array or a 
function. 

In interpreting complex declarators, brackets and parentheses (on the 
right of the identifier) take precedence over asterisks (on the left of the 
identifier). Brackets and parentheses have the same precedence and asso- 
ciate left to right. The type specifier is applied as the last step, when the 
declarator has been fully interpreted. Parentheses can be used to override 
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the default association order in a way that forces a particular interpreta- 
tion. 

A simple rule that can be helpful in interpreting complex declarators is to 
read them “from the inside out.” Start with the identifier and look to the 
right for brackets or parentheses. Interpret these (if any), then look to the 
left for asterisks. If you encounter a right parenthesis at any stage, go back 
and apply these rules to everything within the parentheses before proceed- 
ing. As the last step, apply the type specifier. To illustrate this rule , the 
steps are numbered in order in the following example: 

char *(*(*var)())[10]; 

7 6 4 2 1 3 5 

1. The identifier var is declared as 

2. a pointer to 

3. a function returning 

4. a pointer to 

5 . an array of 10 elements, which are 

6. pointers to 

7. charvalues. 

The following examples provide further illustration and show how 
parentheses can affect the meaning of a declaration. 


Examples: 


1 . /* array of pointers to int values */ 
int *var[5]; 

2. /* pointer to array of int values */ 
int (*var)[5]; 

3. /* function returning pointer to long */ 
long *var (long, long); 

4. /* pointer to function returning long */ 
long (*var)(long,long); 

5. /* array of pointers to functions 
returning structures */ 

struct both { 
int a; 
charb; 

} ( *var[])( struct both, struct both); 
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6. /* function returning pointer 
to an array of double values */ 

double ( *var( double (*)[3] ) )[3]; 

7. /* array of arrays of pointers 
to pointers to unions */ 

union sign { 
int x; 
unsigned y; 

} **var[5][5]; 

8. /* array of pointers to arrays 
of pointers to unions *1 

union sign *(*var[5])[5]; 


In the first example, the array modifier has higher priority than the pointer 
modifier, so var is declared to be an array. The pointer modifier applies to 
the type of the array elements ; the elements are pointers to int values. 

In the second example, parentheses alter the meaning of the declaration in 
the first example. Now the pointer modifier has higher priority than the 
array modifier, and var is declared to be a pointer to an array of 5 int values. 

Function modifiers also have higher priority than pointer modifiers, so the 
third example declares var to be a pointer to a function returning a long 
value. The function is declared to take two long values as arguments. 

The fourth example is similar to the second example. Parentheses give the 
pointer modifier higher priority than the function modifier, and var is 
declared to be a pointer to a function returning a long value. Again, the 
function takes two long arguments. 

The elements of an array may not be functions, but the fifth example 
demonstrates how to declare an array of pointers to functions instead. In 
this example var is declared to be an array of pointers to functions return- 
ing structures with two members. The arguments to the functions are 
declared to be two structures with the same structure type, both. Notice 
that the parentheses surrounding “*var[]” are required. Without them, 
the declaration is an illegal attempt to declare an array of functions, as 
shown below: 

/♦ILLEGAL*/ 

struct both *var[ ]( struct both, struct both); 


The sixth example shows how to declare a function returning a pointer to 
an array, since functions returning arrays are illegal. Here var is declared to 
be a function returning a pointer to an array of 3 double values. The func- 
tion var takes one argument; the argument, like the return value, is a 
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pointer to an array of 3 double values. The argument type is given by a com- 
plex abstract declarator. The parentheses around the asterisk in the argu- 
ment type are required ; without them, the argument type would be an array 
of 3 pointers to double values. See Section 4.9, “Type Names,” for a dis- 
cussion and examples of abstract declarators. 

A pointer can point to another pointer, and an array can contain array ele- 
ments, as the seventh example shows. Here var is an array of 5 elements. 
Each element is a 5-element array of pointers to pointers to unions with 
two members. 

The eighth example shows how the placement of parentheses alters the 
meaning of the declaration. In this example, var is a 5-element array of 
pointers to 5-element arrays of pointers to unions. 


4.4 Variable Declarations 

This section describes the form and meaning of variable declarations. In 
particular, it explains how to declare the following: 

Simple variables Single value variables with integral or 

floating-point type. 

Enumeration variables Simple variables with integral type that hold 
one value from a set of named integer con- 
stants. 

Structures Variables composed of a collection of values 

that may have different types. 

Unions Variables composed of several values of 

different types occupying the same storage 
space. 

Arrays Variables composed of a collection of ele- 

ments with the same type. 

Pointers Variables that point to other variables. These 

variables contain variable locations (in the 
form of addresses) instead of values. 

The variable declarations discussed in this section have the general form: 

[sc- specifier ] type- specifier declarator [, declarator . . .] 

where type- specifier gives the data type of the variable and declarator is the 
variable’s name, possibly modified to declare an array or a pointer type. 
More than one variable can be defined in the declaration by giving multiple 
declarators, separated by commas. 

The sc- specifier gives the storage class of the variable. In some contexts, 
variables can be initialized when they are declared. Storage classes and ini- 
tialization are discussed in Sections 4.6 and 4.7, respectively. 
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4.4.1 Simple Variable Declarations 


Syntax 


sc- specifier type- specifier identifier [, identifier . . ; 

A declaration for a simple variable defines the variable’s name and type. It 
can also define the variable’s storage class, as described later in Section 
4.6. The variable’s name is the identifier given in the declaration. The 
type- specifier gives the name of a defined data type, as described below. 

You can define several variables in the same declaration by giving a list of 
identifiers separated by commas (,). Each identifier in the list names avail- 
able. All variables defined in the declaration have the same type. 


Examples 


1. intx; 

2. unsigned long reply, flag; 

3. double order; 

The first example defines a simple variable x. This variable can hold any 
value in the set defined by the int type in a particular implementation . 

The second example defines two variables, reply and flag. Both variables 
have unsigned long type and hold unsigned integer values. 

The third example defines a variable order that has double type. Floating- 
point values can be assigned to this variable. 


4.4.2 Enumeration Declarations 


Syntax 


enum [tag] {enum- list} identifier [, identifier . . .]; 
enum tag identifier [, identifier ...]; 

An enumeration declaration gives the name of the enumeration variable 
and defines a set of named integer constants (the “enumeration set”). A 
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variable declared to have enumeration type stores any one of the values of 
the enumeration set defined by that type. The integer constants of the 
enumeration set have int type; thus, the storage associated with an 
enumeration variable is the storage required for a single int value. 

Enumeration declarations begin with the enum keyword and have two 
forms, as shown above. In the first form, the values and names of the 
enumeration set are specified in the enum- list, described in detail below. 
The optional tag is an identifier that names the enumeration type defined 
by the enum- list. The identifier names the enumeration variable. More 
than one enumeration variable can be defined in the declaration. 

The second form uses an enumeration tag to refer to an enumeration type. 
The enum- list does not appear in this type of declaration because the 
enumeration type is defined elsewhere. An error is generated if the given 
tag does not refer to a defined enumeration type or if the named type is not 
currently visible. 

An enum- list has the following form: 

identifier [ = constant- expression] 

[, identifier [ = constant- expression ] ] 


Each identifier names a value of the enumeration set. By default, the first 
identifier is associated with the value zero, the next identifier is associated 
with the value one, and so on through the last identifier appearing in the 
declaration. The name of an enumeration constant is equivalent to its 
value. 

The phrase “= constant- expression” overrides the default sequence of 
values. An identifier followed by the phrase “= constant- expression” is 
associated with the value given by constant- expression. The constant- 
expression must have int type and can be negative. The next identifier in the 
list is associated with the value of “constant- expression + 1”, unless it is 
explicitly given another value. 

An enumeration set can contain duplicate constant values, but each 
identifier in an enumeration list must be unique, that is, different from all 
other enumeration identifiers with the same visibility. For example, the 
value zero (0) could be given to two different identifiers, null and zero, in 
the same set. The identifiers in the list must also be distinct from other 
identifiers with the same visibility, including ordinary variable names and 
identifiers in other enumeration lists. Enumeration tags must be distinct 
from other enumeration, structure, and union tags with the same visibility. 
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Examples 


1. enumday{ 

Saturday, 

Sunday = 0, 

monday, 

tuesday, 

Wednesday, 

thursday, 

f rid ay 
} workday; 

2. today = Wednesday; 

3. enum day holiday; 

The first example defines an enumeration type named day and declares a 
variable named workday with that enumeration type. The value 0 is associ- 
ated with Saturday by default. The identifier Sunday is explicitly set to 0. 
The remaining identifiers are given the values 1 through 5 by default. 

In the second example, a value from the set is assigned to the variable 
today. Notice that the name of the enumeration constant is used to assign 
the value. 

In the third example, a variable named holiday is declared to have the 
enumeration type day. Since the day type was previously declared, only 
the enumeration tag is necessary in this declaration. 


4.4.3 Structure Declarations 


Syntax 


struct [tag] {member- declaration- list} declarator [, declarator . ..]; 
s tru c t tag declarator [ , dec la rator...]; 

A structure declaration defines the name of the structure variable and 
specifies a sequence of variable values (called “members” of the structure) 
that can have different types. A variable with structure type holds the 
entire sequence defined by that type. 

Structure declarations begin with the struct keyword and have two forms, 
as shown above. In the first form, the types and names of the structure 
members are specified in the member- declaration- list, described in detail 
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below. The optional tag is an identifier that names the structure type 
defined by the member - declaration- list. 

Each declarator gives the name of a structure variable. The declarator may 
also modify the type of the variable to a pointer to the structure type, an 
array of structures, or a function returning a structure. 

The second form uses a structure tag to refer to a structure type. The 
member- declaration- list does not appear in this type of declaration 
because the structure type is defined elsewhere. The structure type 
definition must be visible for a tag declaration to be used, and the 
definition must appear prior to the tag declaration, unless the tag is used to 
declare a pointer variable or a typedef structure type. These declarations 
can use a structure tag before the structure type is defined, as long as the 
structure definition is visible to the declaration. 

A member- declaration- list is a list of one or more variable or bitfield 
declarations. Each variable declared in the member- declaration- list is 
defined as a member of the structure type. Variable declarations within 
member declaration lists have the same form as the variable declarations 
discussed in this chapter, except that the declarations do not contain 
storage class specifiers or initializers. The structure members can have any 
variable type: fundamental, array, pointer, union, or structure. 

A member cannot be declared to have the type of the structure in which it 
appears. However, a member can be declared as a pointer to the structure 
type in which it appears. This allows you to create linked lists of structures. 


Bitfields 

A bitfield declaration has the following form: 

type- specifier [identifier ] : constant- expression ; 

The bitfield consists of the number of bits specified by constant- 
expression. The type- specifier for a bitfield declaration must specify an 
unsigned integral type, and the constant- expression must be a non- 
negative integer value. Arrays of bitfields, pointers to bitfields, and func- 
tions returning bitfields are not allowed. The optional identifier names the 
bitfield. An unnamed bitfield whose width is specified as zero (0) has a spe- 
cial function: it guarantees that storage for the member following it in the 
declaration list begins on an int boundary. 

The identifiers in a structure declaration list must be unique within that list. 
It is not necessary for the identifiers in the list to be distinct from ordinary 
variable names or from identifiers in other structure declaration lists. 
Structure tags must be distinct from other structure, union, and enumera- 
tion tags having the same visibility. 
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Structure members are stored sequentially in the same order in which they 
are declared. The first member has the lowest memory address and the last 
member the highest. The storage for each member begins on a memory 
boundary appropriate to its type. Therefore, unnamed blanks can occur 
between the members of a structure in memory. 

Bitfields are not stored across boundaries of their declared type. For 
example, a bitfield declared with unsigned int type is either packed into the 
space remaining in the previous int or it begins a new int. 

Examples 


1. struct { 

float x,y; 

} complex; 

2. struct employee { 

char name [20]; 
int id; 
long class; 

} temp; 

3. struct employee student, faculty, staff; 

4. struct sample { 

chare; 
float *pf; 

struct sample *next; 

}x; 

5. struct { 

unsigned icon : 8; 
unsigned color : 4; 
unsigned underline : 1; 
unsigned blink : 1; 

} screen [25] [80]; 

The first example defines a structure variable named complex. This struc- 
ture has two members with float type, x and y. The structure type is not 
named. 

The second example defines a structure variable named temp. The struc- 
ture has three members, name , id, and class. The name member is a 20- 
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element array and id and class are simple members with int and long type, 
respectively. The identifier employee is the structure tag. 

The third example defines three structure variables: student , faculty, and 
staff. Each structure has the same list of three members. The members are 
declared to have the structure type employee, defined in the previous exam- 
ple. 

The fourth example defines a structure variable named x. The first two 
members of the structure are a char variable and a pointer to a float value. 
The third member, next, is declared as a pointer to the structure type being 
defined {sample). 

The fifth example defines a two-dimensional array of structures named 
screen. The array contains 2,000 elements. Each element is an individual 
structure containing four bitfield members: icon, color, underline, and 
blink. 


4.4.4 Union Declarations 


Syntax 


union [tag] { member - declaration - list } declarator [, declarator . . . ]; 
union tag declarator^ declarator...]-, 

A union declaration defines the name of the union variable and specifies a 
set of variable values (called “members” of the union) that can have 
different types. A variable with union type stores any single value defined 
by that type. 

Union declarations have the same forms as structure declarations except 
that they begin with the union keyword instead of the struct keyword. The 
same rules govern structure and union declarations, except that bitfield 
members are not allowed in unions. 

The storage associated with a union variable is the storage required for the 
longest member of the union. When a smaller member is used, the union 
variable may contain unused memory space. All members are stored in the 
same memory space and start at the same address. The stored value is 
overwritten each time a value is assigned to a different member. 
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Examples 


1. union sign { 
int svar; 
unsigned uvar; 

} number; 

2. union { 
char *a, b; 
float f[20]; 

} jack; 

3. union { 
struct { 

char icon; 
unsigned color : 4; 

} windowl, window2, window3, window4; 

} screen [25][80]; 

The first example defines a union variable named number that has two 
members: svar, a signed integer, and uvar, an unsigned integer. This 
declaration allows the current value of number to be stored as either a 
signed or an unsigned value. The union type is named sign. 

The second example defines a union variable named jack. The members 
of the union are, in order, a pointer to a char value, a char value, and an 
array of float values. The storage allocated for jack is the storage required 
for the 20-element array/, since/is the longest member of the union. The 
union type is unnamed. 

The third example defines a two-dimensional array of unions named 
screen. The array contains 2,000 elements. Each element is an individual 
union with four members: windowl, window2, window3, and window4, 
where each member is a structure. Each union element holds one of the 
four possible structure members at any given time. Thus, the screen vari- 
able is a composite of up to four different “windows. ” 


4.4.5 Array Declarations 


Syntax 


type - specifier declarator [constant- expression ]; 
type- specifier declarator [ ] ; 
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A declaration for an array defines the name of the array and the type of 
each element. It can also define the number of elements in the array. A 
variable with array type is considered a pointer to the type of the array ele- 
ments, as described in Section 5.2.2 of Chapter 5, “Expressions and 
Assignments”. 

Array declarations have two forms, as shown above. The declarator gives 
the variable name, and may modify the variable’s type. The brackets ([]) 
following the declarator modify the declarator to array type. The 
constant- expression inside the brackets defines the number of elements in 
the array. Each element has the type given by the type- specifier . The type- 
specifier can specify any type except void and function types. 

The second form omits the constant- expression in brackets. This form can 
be used only if the array is initialized, declared as a formal parameter, or 
declared as a reference to an array explicitly defined elsewhere in the pro- 
gram. 

Arrays of arrays (“multidimensional” arrays) are defined by giving a list of 
bracketed constant- expressions following the array declarator. 

type- specifier declarator[constant- expression ] [constant- expression ] . . . 

Each constant- expression in brackets defines the number of elements in a 
given dimension. Two-dimensional arrays have two bracketed expres- 
sions, three-dimensional arrays have three, and so on. When a multidi- 
mensional array is declared within a function, the first constant- expression 
can be omitted if the array is initialized, declared as a formal parameter, or 
declared as a reference to an array explicitly defined elsewhere in the pro- 
gram. 

Arrays of pointers to various types can be defined by using complex 
declarators, as described earlier in Section 4.3.2. 

The storage associated with an array type is the storage required for all of its 
elements. The elements of an array are stored in contiguous and increasing 
memory locations, from the first element to the last. No blanks occur 
between the elements of an array in storage. 

Arrays are stored by row. For example, the following array consists of 2 
rows with 3 columns each : 

char A [2] [3]; 

The 3 columns of the first row are stored first, followed by the 3 columns of 
the second row. 
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To refer to an individual element of an array, use a subscript expression, 
discussed in Section 5.2.5 of Chapter 5, “Expressions and Assignments’’. 


Examples 


1. intscores[10], game; 

2. float matrix[10][15]; 

3. struct { 

float x,y; 

} complex[100]; 

4. char *name[20]; 

The first example defines an array variable named scores with 10 elements, 
each of which has int type. The variable named game is declared as a sim- 
ple variable with int type. 

The second example defines a two-dimensional array named matrix. The 
array has 150 elements, each having float type. 

The third example defines an array of structures. This array has 100 ele- 
ments. Each element is a structure containing two members. 

The fourth example defines an array of pointers. The array has 20 ele- 
ments. Each element is a pointer to a char value. 


4.4.6 PointerDeclarations 


Syntax 


type- specifier * declarator) 

A pointer declaration defines the name of the pointer variable and the type 
of the object to which the variable points. The declarator defines the 
variable’s name, and may modify its type. The type- specifier gives the type 
of the object. The type can be any fundamental, structure, or union type. 

Pointer variables can also point to functions, arrays, and other pointers. 
To declare more complex pointer types, refer to Section 4.3.2. 
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A pointer to a structure or union type can be declared before the structure 
or union type is defined, as long as the structure or union type definition is 
visible at the time of the declaration. Such declarations are allowed 
because the compiler does not need to know the size of the structure or 
union to allocate space for the pointer variable. The pointer is declared by 
using the structure or union tag. See the fourth example b elow. 

A variable declared as a pointer holds a memory address. The amount of 
storage required for an address and the meaning of the address depends on 
the given implementation of the compiler. Pointers to different types are 
not guaranteed to have the same length . 

In some implementations the special keywords near and far are available 
to modify the size of a pointer. See your system documentation for more 
information. 


Examples 


1. char *message; 

2. int *pointers[10]; 

3. int (*pointer)[10]; 

4. struct list *next, *previous; 

5. struct list { 

char*token; 
int count; 
struct list *next; 

} line; 

The first example defines a pointer variable named message. It points to a 
variable with char type. 

The second example defines an array of pointers named pointers. The 
array has 10 elements. Each element is a pointer to a variable with int type. 

The third example defines a pointer variable named pointer. It points to an 
array with 10 elements. Each element in this array has int type. 

The fourth example defines two pointer variables that point to the struc- 
ture type list. This declaration can appear before the definition of the list 
structure type (see the next example), as long as the list type definition has 
the same visibility as the declaration. 
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The fifth example declares the variable line to have the structure type 
named list. The list structure type is defined to have three members. The 
first member is a pointer to a char value, the second is an int value, and the 
third is a pointer to another list structure. 


4.5 Function Declarations 


Syntax 


[type- specifier ] declarator {[arg- type- list]) [, declarator . . . ]; 

A function declaration defines the name and return type of a function, and 
possibly establishes the types and number of arguments to the function. 
Function declarations, also called forward declarations, do not define the 
function body or parameters. Instead they permit the attributes of the 
function to be known before the function is defined. Function definitions 
are described in detail in Section 7.2 of Chapter 7, “Functions”. ” 

The declarator of the function declaration names the function, and the 
type- specifier gives the function’s return type. If the type- specifier is omit- 
ted from a function declaration, the return type of the function is assumed 
to be int. 

Function declarations may include either the extern or the static storage 
class specifier. Storage class specifiers are discussed in Section 4.6. 


Argument Type List 

The arg- type- list establishes the number and types of the arguments to the 
function. It has the following form: 

[type- name]] type- name...]]] 


The first type- name gives the type of the first argument to the function, the 
second type- name gives the type of the second argument, and so on. Each 
type- name is separated from the next by a comma. If the arg- type- list ends 
with a comma, the number of arguments to the function is variable. How- 
ever, the function is expected to have at least as many arguments as there 
are type- names before the terminating comma. If the arg- type- list con- 
tains only a single comma, the number of arguments to the function is vari- 
able and may be zero. 
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A type- name for a fundamental, structure, or union type consists of the 
type specifier for that type (such as int). The type- names for pointers, 
arrays, and functions are formed by combining a type specifier with an 
‘‘abstract declarator,” that is, a declarator without an identifier. Section 
4.9 explains how to form and interpret abstract declarators. 

The special keyword void can be used in place of the arg- type- list to 
declare a function that has no arguments. The compiler displays a warning 
message if a call to the function or the function definition specifies argu- 
ments. 

One other special construction is allowed in the arg- type- list. The phrase 
void * specifies an argument of any pointer type. This phrase can be used in 
the arg- type- list as if it were a type- name. 

The arg- type- list may be omitted altogether. The parentheses after the 
function identifier are still required, but they are empty. In this form, the 
function declaration establishes neither the number nor the types of argu- 
ments to the function. When this information is omitted, the compiler 
does not perform any type-checking between the actual arguments in a 
function call and the formal parameters of the function definition. See 
Section 7.4 of Chapter 7, “Functions”, for details. 


Return Type 

Functions can return values of any type except arrays and functions. Thus, 
the type- specifier of a function declaration can specify any fundamental, 
structure, or union type. The function identifier can be modified with one 
or more asterisks (*) to declare a pointer return type. 

Although functions are not allowed to return arrays and functions, they 
can return pointers to arrays and functions. Functions that return pointers 
to array or function types are declared by modifying the function identifier 
with asterisks (*), brackets ([]), and parentheses to form a complex 
declarator. Forming and interpreting complex declarators is discussed in 
Section 4.3.2. 


Examples 

1. int add(int, int); 

2. char *strfind (char *,); 

3. void draw(void); 

4. double (*sum(double, double))[3]; 
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5. int (*(*select)(void))(int) 

6. char*p; 
short *q; 

int prt(void *); 

The first example declares a function named add that takes two int argu- 
ments and returns an int value. 

The second example declares a function named strftnd, which returns a 
pointer to a char value. The function takes at least one argument, a 
pointer to a char value. The argument type list ends with a comma, indicat- 
ing that the function may take more arguments. 

The third example declares a function with void return type (returning no 
value). The argument- type- list is also void, meaning no arguments are 
expected for this function. 

In the fourth example, sum is declared as a function returning a pointer to 
an array of 3 double values. The sum function takes two arguments, each a 
double value. 

In the fifth example, the function named select is declared to return a 
pointer to a function taking no arguments and returning a pointer. The 
pointer return value points to a function taking one int argument and 
returning an int value. 

In the sixth example, the function prt is declared to take a pointer argument 
of any type and to return an int. Either the char pointer p or the short 
pointer q could be passed as an argument to prt without producing a type 
mismatch warning. 


4.6 Storage Classes 

The storage class of a variable determines whether the item has a “global” 
or “local” lifetime. An item with a global lifetime exists and has a value 
throughout the duration of the program. All functions have global life- 
times. 

Variables with local lifetimes are allocated new storage each time execu- 
tion control passes to the block in which they are defined. When execution 
passes out of the block, the variables no longer have meaningful values. 
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Although C defines only two types of storage classes, four storage class 
specifiers are available. They are: 

auto 

register 

static 

extern 


Items with auto and register class have local lifetimes. The static and 
extern specifiers refer to items with global lifetimes. 

The four storage class specifiers have distinct meanings because storage 
class specifiers affect the visibility of functions and variables as well as their 
storage class. The term “visibility” refers to the portion of the source pro- 
gram in which the variable or function can be referenced. An item with a 
global lifetime exists throughout the execution of the source program, but 
it may not be “visible” in all parts of the program. Visibility and the related 
concept of lifetime are discussed in Section 3.5 of Chapter 3, “Program 
Structure.” 

The placement of variable or function declarations within source files also 
affects storage class and visibility. Declarations outside of all function 
definitions are said to occur at the “external level;” declarations within 
function definitions occur at the “internal level. ” 

The exact meaning of each storage class specifier depends on whether the 
declaration occurs at the external or the internal level and whether the item 
declared is a variable or a function. The following sections describe the 
meaning of storage class specifiers in each kind of declaration. They also 
explain the default behavior when the storage class specifier is omitted 
from a variable or function declaration. 


4.6. 1 Variable Declarations at the External Level 

Variable declarations at the external level use the static and extern storage 
class specifiers or omit the storage class specifier entirely. The auto and 
register storage class specifiers are not allowed at the external level. 

Variable declarations at the external level are either definitions of variables 
or references to variables defined elsewhere. An external variable declara- 
tion that also initializes the variable (implicitly or explicitly) is a definition 
of the variable. Definitions at the external level can take several forms: 

1. A variable can be defined at the external level by declaring it with 
the static storage class specifier. The static variable can be expli- 
citly initialized, as described in Section 4.7. If the initializer is omit- 
ted, the variable is automatically initialized to zero at compile time. 
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Thus, “static int k = 16;” and static int k; are both considered 
definitions. 

2. A variable is defined when it is explicitly initialized at the external 
level. For example, “int j = 3 is a variable definition. 

Once a variable is defined at the external level, it is visible throughout the 
remainder of the source file in which it appears. The variable is not visible 
above its definition in the same source file, nor is it visible in other source 
files of the program, unless a reference is declared to make it visible, as 
described below. 

A variable can be defined at the external level only once within a source 
file. If the static storage class specifier is given, another variable with the 
same name can be defined with the static storage class specifier in a 
different source file. Since each static definition is visible only in its own 
source file, no conflict occurs. 

The extern storage class specifier is used to declare a reference to a variable 
defined elsewhere. These declarations can be used to make a definition in 
another source file visible or to make a variable visible above its definition 
in the same source file. Once a reference to the variable is declared at the 
external level, the variable is visible throughout the remainder of the 
source file in which the declared reference occurs. 

Declarations that use the extern storage class specifier are not allowed to 
contain initializers, since they refer to variables whose values are already 
defined. 

For an extern reference to be valid, the variable to which it refers must be 
defined once, and only once, at the external level. The definition can be in 
any of the source files that make up the program. 

One special case is not covered by the rules outlined above. You can omit 
both the storage class specifier and the initializer from a variable declara- 
tion at the external level. For example, the declaration “int n;” is a valid 
external declaration. This declaration can have one of two different mean- 
ings, depending on the context: 

1. If a variable by the same name is defined at the external level else- 
where in the program, the declaration is taken to be a reference to 
that variable, exactly as if the extern storage class specifier had been 
used in the declaration . 

2. If no such definition is present, the declared variable is allocated 
storage at fink time and initialized to zero. If more than one such 
declaration appears in the program, storage is allocated for the larg- 
est size declared for the variable. For example, if a program con- 
tains two uninitialized declarations of i at the external level, “int i;” 
and “char i storage space for an int is allocated for i at link time. 
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Example 


y* *********************************************** 

SOURCE FILE ONE 

************************************************/ 


extern int i; 

/* reference to i, defined below */ 


main() 

{ . 

i++; 

/* i equals 4*/ 
next(); 

> 

int i = 3; 

/* definition of i */ 


nextQ 

{ . 

i++; 

printf("%d\n", i); 

/* i equals 5 */ 
otherQ; 

} 

y* *********************************************** 

SOURCE FILE TWO 

************************************************y 

extern int i; 

/* reference to i in first source file */ 

other() 

{ . 

i++; 

printf("%d\n", i); 

/* i equals 6*/ 

} 

The two source files contain a total of three external declarations of i. Only 
one declaration contains an initialization: that declaration, “int i = 3;”, 
defines the global variable i with initial value 3. The extern declaration of i 
at the top of the first source file makes the global variable visible above its 
definition in the file. Without the extern declaration, the mainQ function 
could not reference the global variable i. The extern declaration of i in the 
second source file makes the glob al variable visible in that source file. 
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All three functions perform the same task: they increase i and print it. 
(Assume that the printf function is defined elsewhere in the program.) The 
values printed are 4, 5, and 6. 

If the variable i had not been initialized, it would have been automatically 
set to zero at link time. The values printed in this case would be 1, 2, and 3. 


4.6.2 Variable Declarations at the Internal Level 

Any of the four storage class specifiers can be used for variable declara- 
tions at the internal level. When the storage class specifier is omitted from 
a variable declaration at the internal level, the default storage class is auto. 

The auto storage class specifier declares a variable with a local lifetime. 
The variable is visible only in the block in which it is declared. Declara- 
tions of auto variables can include initializers, as discussed later in this 
chapter. Variables with auto storage class are not initialized automatically, 
so they should be explicitly initialized when declared or assigned initial 
values in statements within the block. If not initialized, the values of auto 
variables are undefined. 

The register storage class specifier tells the compiler to give the variable 
storage in a register, if possible. Register storage usually results in faster 
access time and smaller code size. Variables declared with register storage 
class have the same visibility as auto variables. 

The number of registers that can be used for variable storage is machine 
dependent. If no registers are available when the compiler encounters the 
register declaration, the variable is given auto storage class and stored in 
memory. The compiler assigns register storage to variables in exactly the 
same order in which the declarations appear in the source file. Register 
storage (if available) is only guaranteed for int and pointer types. 

A variable declared at the internal level with the static storage class 
specifier has a global lifetime. The variable is visible only within the block 
in which it is declared. Unlike auto variables, variables declared as static 
retain their values when the block is exited. 

Declarations of static variables can include initializers. If not explicitly ini- 
tialized, a static variable is automatically set to zero. Initialization is per- 
formed once, at compile time; the static variable is not reinitialized each 
time the block is entered. 

A variab le declared with the extern storage class specifier is a reference to a 
variable with the same name defined at the external level in any of the 
source files of the program. The purpose of the internal extern declaration 
is to make the external -level variable definition visible within the block. 
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The internal extern declaration does not change the visibility of the global 
variable in any other part of the program. 


Example 


inti* 1; 
main() 

{ /* reference to i, defined above */ 

extern int i; 

/* initial value is zero ; a is 
visible only within main */ 
static int a; 

/* b is stored in a register, 
if possible */ 
register intb = 0; 

/* default storage class is auto */ 
int c = 0; 

/* values printed are 1, 0, 0, 0 */ 
printf("%d\n%d\n%d\n%d\n", i, a, b, c); 
otherQ; 


other() 

{ 

/*iis redefined */ 
int i = 16; 

/* this a is visible only within other */ 
static int a = 2; 

a += 2; 

/* values printed are 16, 4 */ 
printf("%d\n%d\n", i, a); 

> 


The variable i is defined at the external level with initial value 1. A refer- 
ence to the external-level i is declared in the main() function with an extern 
declaration. The static variable a is automatically set to zero, since the ini- 
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tializer is omitted. The call to printf (assuming the printf function os 
defined elsewhere in the source program) prints out the values 1, 0, 0, 0. 

In the other function, the variable i is redefined as a local variable with ini- 
tial value 16. This does not affect the value of the external-level i. The vari- 
able a is declared as a static variable and initialized to 2. This a does not 
conflict with the a in main , since the visibility of static variables at the inter- 
nal level is restricted to the block in which they are declared. 

The variable a is increased by 2, giving 4 as the result. If the other function 
were called again in the same program, the initial value of a would be 4. 
Internal static variables retain their values when the block in which they 
are declared is exited and reentered. 


4.6.3 Function Declarations 

Function declarations can use either the static or the extern storage class 
specifier. Functions always have global lifetimes. 

The visibility rules for functions are slightly different from the rules for vari- 
ables. Function declarations at the internal level have the same meaning as 
function declarations at the external level. This means that functions can- 
not have block visibility, and the visibility of functions cannot be nested. 
A function declared to be static is visible only within the source file in 
which it is defined. Any function in the same source file can call the static 
function, but functions in other source files cannot. Another static func- 
tion by the same name can be declared in a different source file without 
conflict. 

Functions declared as extern are visible throughout all the source files that 
constitute the program (unless they are later redeclared as static). Any 
function can call an extern function. 

Function declarations that omit the storage class specifier default to 
extern. 


4.7 Initialization 

A variable can be set to an initial value by applying an initializer to the 
declarator in the variable declaration. The value or values of the initializer 
are assigned to the variable. The initializer is preceded by an equal sign (=), 
as shown below: 


= initializer 


Variables of any type can be initialized, with the restrictions outlined 
below. Functions do not take initializers. 
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Declarations that use the extern storage class specifier cannot contain ini- 
tializers. 

Variables declared at the external level can be initialized; if not explicitly 
initialized, they are set to zero at compile time. Any variable declared with 
the static storage class specifier can be initialized. Initializations of static 
variables are performed once, at compile time. If not explicitly initialized, 
static variables are automatically set to zero. 

Initializations of auto and register variables are performed each time exe- 
cution control passes to the block in which they are declared. If the initial- 
izer is omitted from the declaration of an auto or register variable, the ini- 
tial value of the variable is undefined. 

Initializations of auto aggregate types (arrays, structures, and unions) are 
prohibited. Only static aggregates and aggregates declared at the external 
level can be initialized. 

The initial values for external variable declarations and for all static vari- 
ables, whether external or internal, must be constant-expressions. 
Constant-expressions are described in Section 5.2.10 of Chapter 5, 
“Expressions and Assignments.” Automatic and register variables can be 
initialized with either constant or variable values. 

Sections 4.7.1 and 4.7.2 describe how to initialize variables of fundamen- 
tal, pointer, and aggregate types. 


4.7.1 Fundamental and Pointer Types 


Syntax 


var = expression 

The value of expression is assigned to the variable. The conversion rules 
for assignment apply. 


Examples 


1. intx= 10; 

2. register int *px = 0; 
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3. int c = (3*1024); 

4. int *b = &x; 

In the first example, x is initialized to the constant-expression 10. In the 
second example, the pointer px is initialized to zero, producing a “null” 
pointer. The third example uses a constant-expression to initialize c. The 
fourth example initializes the pointer b with the address of another vari- 
able,*. 


4.7.2 Aggregate Types 


Syntax 


var = {initializer- list} 

An initializer- list is a list of initializers separated by commas. Each initial- 
izer in the list is either a constant-expression or an initializer- list. Thus, a 
brace-enclosed list can appear within another initializer- list. This is useful 
for initializing aggregate members of an aggregate, as shown in the exam- 
ples below. 

For each initializer- list, the values of the constant-expressions are 
assigned in order to the members of the aggregate variable. When a union 
is initialized, the initializer- list must be a single constant-expression. The 
value of the constant-expression is assigned to the first member of the 
union. 

If there are fewer values in an initializer- list than there are in the aggregate 
type, the remaining members or elements are initialized to zero. Giving too 
many initial values for the aggregate type causes an error. These rules apply 
to each embedded initializer- list, as well as to the aggregate as a whole. 

For example: 

mtP[4][3] = { 

{ 1 , 1 , 1 }, 

{ 2 , 2 , 2 }, 

{3,3,3,}, 

{4,4,4,}, 

}; 


declares P as a 4 x 3 array and initializes the elements of its first row to 1, the 
elements of its second row to 2, and so on through the fourth row. Notice 
that the initializer- list for the third and fourth rows contains commas after 
the last constant-expression. The last initializer- list (“{4, 4, 4,}”) is also 
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followed by a comma. These extra commas are permitted but are not 
required; the required commas are those that separate constant- 
expressions and initializer - lists. 

If there is no embedded initializer list for an aggregate member, values are 
simply assigned in order to each member of the sub aggregate. Thus, the 
above initialization is equivalent to: 

iiit P[4][3] = { 

1 , 1 , 1 , 2 , 2 , 2 , 3 , 3 , 3 , 4 , 4, 4 

}; 


Braces can also appear around individual initializers in the list. 


Examples 


1. struct list { 
int i, j, k; 
float m[2][3]; 

}x = { 

1 , 

2 , 

3, 

{4.0, 4.0, 4.0} 

}; 


2. union { 
char x[2][3]; 
int i, j,k; 

}y={ 

{’4’} 

}; 


In the first example, the three int members of x are initialized to 1, 2, and 3, 
respectively. The three elements in the first row of m are initialized to 4.0; 
the elements of the remaining row of m are initialized to zero by default. 

In the second example the union variable^ is initialized. The first element 
of the union is an array, so the initializer is an aggregate initializer. The ini- 
tializer list “{T}” gives values to the first row of the array. Since only one 
value appears in the list, the element in the first column is initialized to the 
character “1”, and the remaining two elements in the row are initialized to 
zero (the null character), by default. Similarly, the first element of the 
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second row of “x” is initialized to the character “4” , and the remaining two 
elements in the row are initialized to zero . 


4.7.3 String Initializers 

An array can be initialized with a string literal. Forexample: 
charcode[] = "abc"; 

initializes code as a four-element array of characters. The fourth element is 
the null character that terminates all string literals. 

If the array size is specified and the string is longer than the specified size of 
the array, the extra characters are simply discarded. The following 
declaration initializes code as a three-element character array: 

char code[3] = "abed"; 

Only the first three characters of the initializer are assigned to code. The 
character “d” and the null character are discarded. Note that some com- 
pilers return a warning message when this happens. 

If the string is shorter than the specified size of the array, the remaining ele- 
ments of the array are initialized to zero (the null character). 


4.8 Type Declarations 

A type declaration defines the name and members of a structure or union 
type, or the name and enumeration set of an enumeration type. The name 
of a declared type can be used in variable or function declarations to refer 
to that type. This is useful if many variables and functions have the same 
type. 

A typedef declaration defines a type specifier for a type. These declara- 
tions are used to set up shorter or more meaningful names for types already 
defined by C or for types declaredby the user. 


4.8. 1 Structure, Union, and Enumeration Types 


Declarations of structure, union, and enumeration types have the same 
general form as variable declarations of those types. In type declarations, 
the variable identifier is omitted, since no variable is declared. The tag is 
mandatory; it names the structure, union, or enumeration type. The 
member- declaration- list or enum- list defining the type must appear in the 
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type declaration; the abbreviated form of variable declarations, in which a 
tag refers to a type defined elsewhere, is not legal for type declarations. 


Examples: 


1. enum status { 
loss = -1, 
bye, 
tie = 0, 
win 


}; 


2. struct student { 
charname[20]; 
int id, class; 

}; 


The first example declares an enumeration type named status . The name 
of the type can be used in declarations of enumeration variables. The 
identifier loss is explicitly set to -1. Both bye and tie are associated with the 
value 0, and win is given the value 1. 

The second example declares a structure type named student. A structure 
variable can be declared to have student type with a declaration such as 
“struct student employee;”. 


4.0.1 typedef Declarations 


Syntax 


typedef type- specifier declarator [, declarator . . .]; 

A typedef declaration is analogous to a variable declaration except that the 
typedef keyword appears in place of a storage class specifier. The declara- 
tion is interpreted in the same way as variable and function declarations, 
but the identifier, instead of taking on the type specified by the declaration, 
becomes a new keyword for the type. 
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typedef does not create types. It creates synonyms for existing types or 
names for types that could be specified in other ways. Any type can be 
declared with typedef, including pointer, function, and array types. A 
typedef name for a pointer to a structure or union type can be declared 
before the structure or union type is defined, as long as the definition has 
the same visibility as the declaration. 


Examples 


1. typedef int WHOLE; 

2. typedef struct club { 
charname[30]; 

int size, year; 

} GROUP ; 

3. typedef GROUP *PG; 

4. typedef void DRAWF(int, int); 

The first example declares WHOLE to be a synonym for int. 

The second example declares GROUP as a structure type with three 
members. Since a structure tag, club , is also specified, either the typedef 
name (GROUP) or the structure tag can be used in declarations. 

The third example uses the previous typedef name to declare a pointer 
type. The type PG is declared as a pointer to the GROUP type, which in 
turn is defined as a structure type. 

The final example provides the type DRAWF for a function returning no 
value and taking two int arguments. This means, for example, that the 
declaration “DRAWF box;” is equivalent to the declaration “void 
box(int, int);”. 


4.9 Type Names 

A “type name” specifies a particular data type. Type names are used in 
three contexts: in the argument type lists of function declarations, in type 
casts, and in sizeof operations. Argument type lists are discussed in Sec- 
tion 4.5. Type casts and sizeof operations are discussed in Section 5.7.2 
and 5.3.4, respectively, of Chapter 5, “Expressions and Assignments”. 

The type names for fundamental, enumeration, structure, and union types 
are simply the type specifiers for those types. 
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A type name for a pointer, array, or function type has the form: 
type- specifier abstract- declarator 

An abstract declarator is a declarator without an identifier, consisting 
solely of one or more pointer, array, or function modifiers. The pointer 
modifier (*) always appears before the identifier in a declarator, while array 
([ ]) and function (( )) modifiers appear after the identifier. It is thus possi- 
ble to determine where the identifier would appear in an abstract declara- 
tor and to interpret the declarator accordingly. 

Abstract declarators can be complex. Parentheses in a complex abstract 
declarator specify a particular interpretation, just as they do for the com- 
plex declarators in declarations. 

When you give a function type with an abstract declarator, you can include 
the function’s argument type list, which also consists of type names. See 
the second and fourth examples below. 

The abstract declarator “( )” alone is not allowed because it is ambiguous. 
It is impossible to determine whether the implied identifier belongs inside 
the parentheses (in which case it is an unmodified type) or before the 
parentheses (a function type). 

The type specifiers established through typedef declarations also qualify as 
type names. 


Examples: 


1. long* 

2. double *(double, double) 

3. int(*)[5] 

4. int(*)(void) 

The first example gives the type name for “pointer to long” type. 

The second example is the type name for a function that takes two double 
arguments and returns a pointer to a double value. 

The third and fourth examples show how parentheses modify complex 
abstract declarators. Example 3 gives the name for a pointer to an array of 
five int values. Example 4 names a pointer to a function taking no argu- 
ments and returning an int. 
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5.1 Introduction 

This chapter describes how to form expressions and make assignments in 
the C language. An expression is a combination of operands and operators 
that yields (“expresses”) a single value. An operand is a constant or vari- 
able value that is manipulated in the expression. Each operand of an 
expression is also an expression, since it represents a single value. Opera- 
tors specify how the operand or operands of the expression are manipu- 
lated. 

In C, assignments are considered expressions. An assignment yields a 
value. Its value is the value being assigned. In addition to the simple assign- 
ment operator (=), C offers complex assignment operators that both 
transform and assign their operands. 

The value resulting from an expression’s evaluation depends on the rela- 
tive precedence of operators in the expression and side effects, if present. 
The precedence of operators determines the grouping of operands in an 
expression. Side effects are changes caused by the evaluation of an expres- 
sion. In an expression with side effects, the evaluation of one operand can 
affect the value of another. With some operators, the order in which 
operands are evaluated also affects the result of the expression. 

The value represented by each operand in an expression has a type, which 
may be converted to a different type in certain contexts. Type conversions 
take place in assignments, type casts, function calls, and operations. 


5.2 Operands 

A C operand is a constant, an identifier, a string, a function call, a sub- 
script expression, a member selection expression, or a more complex 
expression formed by combining operands with operators or enclosing 
operands in parentheses. Any operand that yields a constant value is 
called a “constant-expression.” 

Every operand has a type. The following sections discuss the type of value 
each kind of operand represents. An operand can be cast from its original 
type to another type by means of a “type-cast” operation. A type-cast 
expression can also form an operand of an expression. 


5.2.1 Constants 

A constant operand has the value and type of the constant value it 
represents. A character constant has char type. An integer constant can 
have either int or long type, depending on the integer’s size and how the 
value was specified. Floating-point constants always have double type. 
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String literals are considered arrays of characters and are discussed in Sec- 
tion 5.2.3. 


5.2.2 Identifiers 

An identifier names a variable or function. Every identifier has a type, 
which is established when the identifier is declared. The value of an 
identifier depends upon its type, as follows: 

• Identifiers of integral and floating-point types represent values of 
the corresponding type. 

• An identifier of enum type represents one constant value of a set of 
constant values. The value of the identifier is the constant value. Its 
type is int, by definition of the enum type. 

• An identifier of struct or union type represents a value of the 
specified struct or union type. 

® An identifier declared as a pointer represents a pointer to the 
specified type. 

© An identifier declared as an array represents a pointer whose value 
is the address of the first element of the array. The type addressed 
by the pointer is the type of the first element of the array. For 
example, if series is declared to be a ten-element integer array, the 
identifier series expresses the address of the array, while the sub- 
script expression “series[/i]” (where n is an integer in the range zero 
to nine) refers to a variable integer element of series. Subscript 
expressions are discussed in Section 5.2.5. 

The address of an array does not change during the execution of 
the program, although the values of the individual elements can 
change. The pointer value represented by an array identifier is not 
a variable, and an array identifier cannot form the left-hand 
operand of an assignment operation. 

© An identifier declared as a function represents a pointer whose 
value is the address of the function. The type addressed by the 
pointer is a function returning a value of a specified type. The 
address of a function does not change during the execution of a 
program; only the return value varies. Thus, function identifiers 
cannot be left-hand operands in assignment operations. 


5.2.3 Strings 

A string literal consists of a list of characters enclosed in double quotes, as 
shown below: 

", string " 

A string literal is stored as an array of elements with char type. The string 
literal represents the address of the first element of the array. The address 
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of the string’s first element is a constant, so the value represented by a 
string expression is a constant. 

Since string literals are effectively pointers, they can be used in contexts 
that allow pointer values, and they are subject to the same restrictions as 
pointers. String literals have one additional restriction: they are not vari- 
ables and cannot be left-hand operands in assignment operations. 

The last character of a string is always the null character, “\0”. The null 
character is not visible in the string expression, but it is added as the last 
element when the string is stored. Thus, the string abc actually has four 
characters rather than three. 


5.2.4 Function Calls 


Syntax 


expression ( expression- list ) 

A function call consists of an expression followed by an expression- list in 
parentheses, where expression evaluates to a function address (for exam- 
ple, a function identifier), and expression- list is a list of expressions whose 
values, the actual arguments, are passed to the function. The expression- 
list can be empty. 

A function call expression has the value and type of the function’s return 
value. If the function’s return type is void, the function call expression also 
has void type. If control returns from the called function without execu- 
tion of a return statement, the value of the function call is undefined. 

See Section 7.4 of Chapter 7, “Functions”,” for a detailed discussion of 
function calls. 


5.2.5 SubscriptExpressions 


Syntax 


expression 1 [ express ion2 ] 

A subscript expression represents the value at the address that is expres- 
sion 2 positions beyond expression!, expression! is any pointer value (such 
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as an array identifier) and expression 2 is an integer value, expression 2 must 
be enclosed in brackets ([ ]). 

Subscript expressions are generally used to refer to array elements, but a 
subscript can be applied to any pointer. 

The subscript expression is evaluated by adding the integer value ( expres- 
sion. 2) to the pointer value (< expression 1), then applying the indirection 
operator (*) to the result. (See Section 5.3.3 for a discussion of the indirec- 
tion operator.) In effect, for a one-dimensional array, the following four 
expressions are equivalent, assuming that a is a pointer and b is an integer. 

a[b] 

*(a + b) 

*(b + a) 
b[a] 

According to the conversion rules of the addition operator (see Section 
5.3.6), the integer value is converted to an address offset by multiplying it 
by the length of the type addressed by the pointer . 

For example, suppose the identifier line refers to an array of int values. To 
evaluate the expression line[i], the integer value i is multiplied by the length 
of an int. The converted value of i represents i int positions. This con- 
verted value is added to the original pointer value (line) to yield an address 
that is offset i int positions from line . 

As the last step in evaluating the subscript expression, the indirection 
operator is applied to the new address. The result is the value of the array 
element at that position (intuitively, line[i]). 

Notice that the subscript expression : 

line[0] 

yields the value of the first element of a line , since the offset from the 
address represented by a line is zero. Similarly, an expression such as: 

line[5] 

refers to the element offset five positions from line, or the sixth element of 
the array. 


Multidimensional Array References 

A subscript expression can be subscripted, as follows: 
expression! [< expression 2] [expression ^]. . . 
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Subscript expressions associate left to right. The leftmost subscript expres- 
sion, expressionl[expression2\, is evaluated first. The address that results 
from adding expression 1 and expression 2 forms the pointer expression to 
which expression3 is added. The indirection operator (*) is applied after 
the last subscripted expression is evaluated. However, the indirection 
operator is not applied at all if the final pointer value addresses an array 
type. See the third example below. 

Expressions with multiple subscripts refer to elements of multidimensional 
arrays. A multidimensional array is an array whose elements are arrays. 
The first element of a three-dimensional array, for example, is an array 
with two dimensions. 


Examples: 


intprop[3][4][6]; 
int i, *ip; 

1. i = prop[0][0][l]; 

2. i = prop[2][l][3]; 

3. ip — prop[2][l]; 

The array named prop has 3 elements, each of which is a 4-by-6 array of int 
values. 

Example 1 shows how to refer to the second individual int element of prop. 
Arrays are stored by row, so the last subscript varies fastest. 

The second example shows a more complex reference to an individual ele- 
ment of prop. To evaluate the expression, the first subscript, 2, is multi- 
plied by the size of a 4-by-6 int array and added to the pointer value prop. 
The result points to a 6-element array, the third element of the selected 4- 
by-6 array. 

Next, the second subscript, 1, is multiplied by the size of the 6-element int 
array and added to the address represented by prop[2]. 

Each element of the 6-element array is an int value, so the final subscript, 
3, is multiplied by the size of an int before it is added to prop[2 ] [1]. The 
resulting pointer addresses the fourth element of the 6-element array. 

The last step in evaluating the expression prop[2 ] [7] [3] applies the indirec- 
tion operator to the pointer value. The result is the int element at that 
address. 
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Example 3 shows a case where the indirection operator is not applied. The 
expression prop[2\ [7] is a valid reference to the 3-dimensional array prop ; 
the result of the expression is a pointer value that addresses an array with 1 
dimension. Since the pointer value addresses an array type, the indirection 
operator is not applied . 


5.2.6 Member Selection Expressions 


Syntax 


expression . iden tifier 
expressions identifier 

Member selection expressions refer to members of structures and unions. 
A member selection expression has the value and type of the selected 
member. 

In the first form, “ expression. identifier ” , expression represents a value of 
struct or union type. The identifier names a member of the specified struc- 
ture or union. 

In the second form, “ expressions identifier ” , expression represents a 
pointer to a structure or union. The identifier names a member of the 
specified structure or union. 

The two forms of member selection expressions have a similar effect. In 
fact, expressions involving the pointer selection operator (->) are short- 
hand versions of expressions using the period (.) in cases where the expres- 
sion before the period consists of the indirection operator (*) applied to a 
pointer value. (The indirection operator is discussed in Section 5.3.3.) 
Thus: 


expressions identifier 
is equivalent to: 

(* expression), identifier 
when expression is a pointer value. 
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Examples 


struct pair { 
int a; 
intb; 

struct pair *sp; 

} item, listflO]; 

1. item.sp = &item; 

2. (item.sp)->a = 24; 

3. list[8].b = 12; 


In the first example, the address of the item structure is assigned to the sp 
member of the structure. This means that item contains a pointer to itself. 

In the second example, the pointer expression “item.sp” is used with the 
pointer selection operator (- > ) to assign a value to the member a . 

The third example shows how to select an individual structure member 
from an array of structures. 


5.2.7 Expressions with Operators 

Expressions with operators can be unary, binary, or ternary expressions. 
A unary expression consists of an operand prefixed by an unary operator 
(“unop”) or an operand enclosed in parentheses and preceded by the 
sizeof keyword: 

unop operand 
sizeof {operand) 

A binary expression consists of two operands joined by a binary operator 
(“binop”): 

operand binop operand 

A ternary expression consists of three operands joined by the ternary (? :) 
operator: 

operand ? operand : operand 

Assignment expressions use unary or binary assignment operators. The 
unary assignment operators are the increment (++) and decrement ( — ) 
operators. The binary assignment operators are the simple assignment 
operator (=) and the compound assignment operators (referred to as 
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“compound-assign-ops”). Each compound assignment operator is a 
combination of another binary operator with the simple assignment opera- 
tor. The forms of assignment expressions are: 

operand++ 
operand — 

++operand 
— operand 
operand = operand 

operand compound - assignment - op operand 


5.2.8 Expressions in Parentheses 

Any operand can be enclosed in parentheses. The parentheses have no 
effect on the type or value of the enclosed expression. For example, in the 
expression: 

(10 + 5)/ 5 

the parentheses around “10 + 5” mean that the value of “10 + 5” is the left 
operand of the “/” (division) operator. The result of “(10 + 5) / 5” is 3. 
Without the parentheses, “10+5/ 5” would evaluate to 11. 

Although parentheses affect the way operands are grouped in an expres- 
sion, they cannot guarantee a particular order of evaluation for the expres- 
sion. 


5.2.9 Type- Cast Expressions 

A type-cast expression has the following form: 

{type- name) operand 

Type-cast conversions are discussed in Section 5.7.2; type names are dis- 
cussed in Section 4.9 of Chapter 4, “Declarations”.” 


5.2.10 Constant- Expressions 

A constant-expression is any expression that evaluates to a constant. The 
operands of a constant-expression can be integer constants, character 
constants, floating-point constants, enumeration constants, type casts to 
integral and floating-point types, and other constant-expressions. The 
operands can be combined and modified using operators, as described in 
Section 5.2.7, with some restrictions. 
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Constant-expressions may not use assignment operators (see Section 5.4) 
or the binary sequential evaluation operator (,). The unary address-of 
operator (&) can be used only in certain initializations (see the last para- 
graph of Section 5.2. 10). 

Constant-expressions used in preprocessor directives are subject to addi- 
tional restrictions, and are consequently known as restricted- constant- 
expressions. A restricted- constant- expression cannot contain sizeof 
expressions, enumeration constants, or type casts to any type. It can, how- 
ever, contain the special constant-expression “defined (identifier)” . See 
Section 8.2. 1 of Chapter 8, “Preprocessor Directives”, for details. 

These additional restrictions also apply to constant-expressions used to 
initialize variables at the external level. However, such expressions are 
allowed to apply the unary address-of operator (&) to other external -level 
variables with fundamental, structure, and union types and to external- 
level arrays subscripted with a constant-expression. In these expressions, 
a constant-expression not involving the address-of operator can be added 
to or subtracted from the address expression. 


5.3 Operators 

C operators take one operand (unary operators), two operands (binary 
operators), or three operands (the ternary operator). 

Unary operators prefix their operand and associate right to left. C’s unary 
operators are: 

- ~ ! Complement operators 

* & Indirection and address-of operators 

sizeof Size operator 

Binary operators associate left to right. The binary operators are: 

* / % Multiplicative operators 

+ - Additive operators 

<< >> Shift operators 

< > <= >= == != Relational operators 

& |~ Bitwise operators 

&& || Logical operators 

, Sequential evaluation operator 

C has one ternary operator, the conditional operator (? :). It associates 
right to left. 


5.3.1 Usual Arithmetic Conversions 

Most C operators perform type conversions to bring the operands of an 
expression to a common type or to extend short values to the integer size 
used in machine operations. The conversions performed by C operators 
depend on the specific operator and the type of the operand or operands. 
However, many operators perform similar conversions on operands of 
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integral and floating-point types. These conversions are known as “arith- 
metic” conversions because they apply to the types of values ordinarily 
used in arithmetic. 

The arithmetic conversions summarized below are called the “usual arith- 
metic conversions.” The discussion of each operator in the following sec- 
tions specifies whether the operator performs the usual arithmetic conver- 
sions and also specifies the additional conversions, if any, the operator 
performs. 

The specific path of each type of conversion is outlined in Section 5.7. 

The usual arithmetic conversions proceed in order as follows: 

1. Any operands of float type are converted to double type. 

2. If one operand has double type, the other operand is converted to 

double. 

3. Any operands of char or short type are converted to int. 

4. Any operands of unsigned char or unsigned short type are con- 
verted to unsigned int type. 

5. If one operand is of type unsigned long, the other operand is con- 
verted to unsigned long. 

6. If one operand is of type long, the other operand is converted to 

long. 

7. If one operand is of type unsigned int, the other operand is con- 
verted to unsigned int. 


5.3.2 Complement Operators 


Arithmetic Negation (-) 

The arithmetic negation operator (-) produces the negative (two’s comple- 
ment) of its operand. 


The operand must bean integral or floating-point value. 
The usual arithmetic conversions are performed. 


Bitwise Complement C) 

The bitwise complement operator (~) produces the bitwise complement of 
its operand. The operand must be of integral type. The usual arithmetic 
conversions are performed. The result has the type of the operand after 
conversion. 
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LogicalNOT (!) 

The logical NOT operator (!) produces the value zero if its operand is true 
(nonzero) and the value one if its operand is false (zero). The result has int 
type. The operand must be an integral, floating-point, or pointer value. 


Examples: 


1. short x = 987; 
x= -x; 

2. unsigned shorty = 0xaaaa; 

y=~y; 

3. if ( !(x < y)); 

In the first example, the new value of x is the negative of 987, or -987. 

In the second example, the new value assigned to y is the one’s comple- 
ment of the unsigned value Oxaaaa, or 0x5555. 

In the third example, if x is greater than or equal to y, the result of the 
expression is one (true). If * is less than y, the result is zero (false). 


5.3.3 Indirection and Address- of Operators 


Indirection (*) 

The indirection operator (*) accesses a value indirectly, through a pointer. 
The operand must be a pointer value. The result of the operation is the 
value to which the operand points. The result type is the type addressed by 
the pointer operand. If the pointer value is null, the result is unpredictable. 


Address- of (&) 


The address-of operator (&) takes the address of its operand. The 
operand can be any value that can appear as the left-hand value of an 
assignment operation. (Assignment operations are discussed in Section 
5.4.) The result of the address operation is a pointer to the operand. The 
type addressed by the pointer is the type of the operand . 

The address-of operator cannot be applied to a bitfield member of a struc- 
ture, nor can it be applied to an identifier declared with the register storage 
class specifier. 
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Examples: 


int *pa, x; 
int a[20]; 

1. pa = &a[5]; 

2. x=*pa; 

In the first example, the address-of operator (&) takes the address of the 
sixth element of the array a. The result is stored in the pointer variable pa. 

The indirection operator (*) is used in the second example to access the int 
value at the address stored in pa. The value is assigned to the integer vari- 
able*. 


5.3.4 Sizeof Operator 

The sizeof operator determines the amount of storage associated with an 
identifier or a type. A sizeof expression has the form: 

s\zeof(name) 

where name is either an identifier or a type name. The type name may not 
be void . The value of a s izeof expression is the amount of storage, in bytes, 
associated with the named identifier or type. 

When the sizeof operator is applied to an array identifier, the result is the 
size of the entire array in bytes rather than the size of the pointer 
represented by the array identifier. 

When the sizeof operator is applied to a structure or union type name, or to 
an identifier of structure or union type, the result is the actual size in bytes 
of the structure or union, which may include internal and trailing padding 
used to align the members of the structure or union on memory boun- 
daries. Thus, the result may not correspond to the size calculated by adding 
up the storage requirements of the members. 


Example: 


buffer = calloc( 100, sizeof (int)); 

With the sizeof operator you can avoid specifying machine-dependent 
data sizes in your program. The above example uses the sizeof operator to 
pass the size of an int. which varies across machines, as an argument to a 
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function named calloc. The value returned by the function is stored in 
buffer. 


5.3.5 Multiplicative Operators 

The multiplicative operators perform multiplication (*), division (/), and 
remainder (%) operations. The operands of the remainder operator (%) 
must be integral; the multiplication (*) and division (/) operators take 
integral and floating-point operands. The types of the operands can be 
different. The multiplicative operators perform the usual arithmetic 
conversions on the operands. The type of the result is the type of the 
operands after conversion. 

The conversions performed by the multiplicative operators make no provi- 
sion for overflow or underflow conditions. Information is lost if the result 
of a multiplicative operation cannot be represented in the type of the 
operands after conversion. 


Multiplication (*) 

The multiplication operator (*) specifies that its two operands are to be 
multiplied. 


Division (/) 

The division operator (/) specifies that its first operand is to be divided by 
the second. When two integers are divided, the result, if not an integer, is 
truncated. If both operands are positive or unsigned, the result is trun- 
cated toward zero. The direction of truncation when either operand is 
negative may be either toward or away from zero, depending on the imple- 
mentation. Division by zero gives unpredictable results. 


Remainder (%) 

The result of the remainder operator (%) is the remainder when the first 
operand is divided by the second . 

Examples: 

int i=10, j = 3, n; 
double x = 2.0, y; 

1. y = x*i; 
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2. n = i / j ; 

3. n = i % j; 

In the first example, x is multiplied by i to give the value 20.0. The result has 
double type. 

In the second example, 10 is divided by 3. The result is truncated toward 
zero, yielding the integer value 3. 

In the third example, n is assigned the integer remainder 1 when 10 is 
divided by 3. 


5.3.6 Additive Operators 

The additive operators perform addition (+) and subtraction (-). The 
operands can be integral or floating-point values; some additive opera- 
tions can also be performed on pointer values, as outlined under the dis- 
cussion of each operator. The usual arithmetic conversions are performed 
on integral and floating-point operands. The type of the result is the type 
of the operands after conversion . 

The conversions performed by the additive operators make no provision 
for overflow or underflow conditions. Information is lost if the result of an 
additive operation cannot be represented in the type of the operands after 
conversion. 


Addition (+) 

The addition operator (+) specifies addition of its two operands. The 
operands can have integral or floating-point types, as described above, or 
one operand can be a pointer and the other an integer. When an integer is 
added to a pointer, the integer value (i) is converted by multiplying it by the 
length of the value addressed by the pointer. After conversion, the integer 
value represents i memory positions, where each position has the length 
specified by the pointer type. When the converted integer value is added to 
the pointer value, the result is a new pointer value expressing the address i 
positions from the original address. The new pointer value addresses the 
same type as the original pointer value. 


Subtraction (-) 

The subtraction operator (-) subtracts its second operand from the first. 
The operands can be integral or floating-point values, as described above. 
The subtraction operator also allows the subtraction of an integer from a 
pointer value and the subtraction of two pointer values. 
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When an integer value is subtracted from a pointer value, the same conver- 
sions take place as with addition of a pointer and integer. The subtraction 
operator converts the integer value with respect to the type addressed by 
the pointer value. The result is the memory address i positions before the 
original address, where i is the integer value and each position is the length 
of the type addressed by the pointer value. The new pointer points to the 
type addressed by the original pointer value. 

Two pointer values can be subtracted if they point to the same type. The 
difference between the two pointers is converted to a signed integer value 
by dividing the difference by the length of the type the pointers address. 
The result represents the number of memory positions of that type 
between the two addresses. The result is only guaranteed to be meaningful 
for two elements of the same array, as discussed below. 


Pointer Arithmetic 

Additive operations involving a pointer and an integer generally give mean- 
ingful results only when the pointer operand addresses an array member 
and the integer value produces an offset within the bounds of the same 
array. The conversion of the integer value to an address offset assumes that 
only memory positions of the same size lie between the original address 
and the address plus offset. 

This assumption is valid for array members. An array is by definition a 
series of values of the same type; its elements reside in contiguous memory 
locations. Storage of any types except array elements is not guaranteed to 
be completely filled. That is, blanks can occur between memory positions, 
even positions of the same type. Adding to or subtracting from addresses 
referring to any values but array elements gives unpredictable results. 

Similarly, the conversion involved in the subtraction of two pointer values 
assumes that only values of the same type, with no blanks, lie between the 
two addresses given by the operands. 

Additive operations between pointer and integer values on machines with 
segmented architecture must take the segment addressing conventions 
into account. In some cases these operations may not be valid. See your 
system documentation for more information. 


Examples: 


int i = 4, j; 
float x[10]; 
float *px; 


I 
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1. px=&x[4] + i; 

2. j = &x[i] - &x[i-2]; 

In the first example, the integer operand i is added to the address of the 
fifth element of x. The value of i is multiplied by the length of a float and 
added to “&x[4]” . The resulting pointer value is the address of “x[8]’\ 

In the second example, the address of the third element of x (“x[i-2]”) is 
subtracted from the address of the fifth element of x (“x[i]”). The 
difference is divid-ed by the length of a float. The result is the integer value 
- 2 . 


5.3.7 Shift Operators 

The shift operators shift their first operand left (< < ) or right (> > ) by the 
number of positions the second operand specifies. Both operands must be 
integral values. The usual arithmetic conversions are performed. The type 
of the result is the type of the operands after conversion . 

For leftward shifts, the vacated right bits are filled with zeros. In a right- 
ward shift, the method of filling left bits depends on the type (after conver- 
sion) of the first operand. If it is unsigned, vacated left bits will be filled 
with zeros. Otherwise, vacated left bits are filled with copies of the sign bit. 

The result of a shift operation is undefined if the second operand is nega- 
tive. 

The conversions performed by the shift operators make no provision for 
overflow or underflow conditions. Information is lost if the result of a shift 
operation cannot be represented in the type of the first operand after 
conversion. 


Example: 


unsigned intx, y, z; 

x = OxOOaa; 
y = 0x5500; 

z = (x < < 8) + (y > > 8); 

In the above example, x is shifted left by 8 positions andy is shifted right 8 
positions. The shifted values are added, giving0xaa55, and assigned to z. 
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5.3.8 Relational Operators 

The binary relational operators test their first operand against the second 
to determine if the relation specified by the operator holds true. The result 
of a relational expression is either one (if the tested relation holds) or zero 
(if it does not). The type of the result is int. The relational operators test 
the following relationships. 

< First operand less than second operand 
> First operand greater than second operand 
<= First operand less than or equal to second operand 
>= First operand greater than or equal to second operand 

== First operand equal to second operand 
!= First operand not equal to second operand 


The operands can have integral, floating-point, or pointer type. The types 
of the operands can be different. The usual arithmetic conversions are per- 
formed on integral and floating-point operands. 

One or both operands of the equality (==) and inequality (!=) operators 
can have enum type. An enum value is converted in the same manner as an 
int value. 

The operands of any relational operator can be two pointers to the same 
type. For the equality (==) and inequality (!=) operators the result of the 
comparison reflects whether the two pointers address the same memory 
location. The result of pointer comparisons involving the other operators 
(<, >, <=, >=) reflects the relative position of two memory addresses. 

Since the address of a given value is arbitrary, comparisons between the 
addresses of two unrelated values are generally meaningless. Comparisons 
between the addresses of different elements of the same array can be use- 
ful, however, since array elements are guaranteed to be stored in order 
from the first element to the last. The address of the first array element is 
“less than” the address of the last element. 

A pointer value can be compared for equality (==) or inequality (!=) to the 
constant value zero (0). A pointer with a value of zero does not point to a 
memory location: it is called a “null” pointer. A pointer value is equal to 
zero only if it is explicitly given that value through assignment or initializa- 
tion. 
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Examples: 


intx = 0, y = 0; 

1. x<y 

2. x> y 

3. x <=y 

4. x> = y 

5. x==y 

6. x !=y 

When x and y are equal, expressions 3, 4, and 5 have the value one and 
expressions 1, 2, and 6 have the value zero. 


5.3.9 Bitwise Operators 

The bitwise operators perform bitwise AND (&), inclusive OR (|), and 
exclusive OR ( ) operations. The operands of bitwise operators must have 
integral type, but their types can be different. The usual arithmetic conver- 
sions are performed. The type of the result is the type of the operands after 
conversion. 


Bitwise AND (&) 

The bitwise AND (&) operator compares each bit of its first operand to the 
corresponding bit of the second operand. If both bits are ones, the 
corresponding bit of the result is set to one. Otherwise, the corresponding 
result bit is set to zero. 


Bitwise Inclusive OR (|) 

The bitwise inclusive OR ( | ) operator compares each bit of its first operand 
to the corresponding bit of the second operand. If either of the compared 
bits is a one, the corresponding bit of the result is set to one. Otherwise, 
both bits are zeros, and the corresponding result bit is set to zero. 


Bitwise Exclusive OR ( ) 

The bitwise exclusive OR f) operator compares each bit of its first 
operand to the corresponding bit of the second operand. If one of the 
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compared bits is a zero and the other bit is a one, the corresponding bit of 
the result is set to one. Otherwise, the corresponding result bit is set to 
zero. 


Examples 


short i = OxabOO; 
short j = 0xabcd; 
short n; 

1. n = i&j; 

2. n = i | j ; 

3. n = i ~ j ; 

The result assigned to n in the first example is the same as /, OxabOO. The bit- 
wise inclusive OR in the second example results in the value Oxabcd, while 
the bitwise exclusive OR in the third example produces OxOOcd. 


5.3.10 Logical Operators 

The logical operators perform logical AND (&&) and OR (| |) operations. 
The operands of the logical operators must have integral, floating-point, 
or pointer type. The types of the operands can be different. 

The operands of logical AND and OR expressions are evaluated left to 
right. If the value of the first operand is sufficient to determine the result of 
the operation, the second operand is not evaluated. 

These operators do not perform the standard arithmetic conversions. 
Instead, they evaluate each operand in terms of its equivalence to zero. A 
pointer has a value of zero only if it is explicitly set to zero through assign- 
ment or initialization. 

The result of a logical operation is either zero or one, as described below. 
The type of the result is int. 


Logical AND (&&) 

The logical AND operator (&&) produces the value one if both operands 
have nonzero values. If either operand is equal to zero, the result is zero. If 
the first operand of a logical AND operation has a value of zero, the 
second operand is not evaluated. 
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Logical OR (||) 

The logical OR operator (| |) performs an inclusive OR on its operands. It 
produces the value zero if both operands have zero values. If either 
operand has a nonzero value, the result is one. If the first operand of a logi- 
cal OR operation has a nonzero value, the second operand is not 
evaluated. 


Examples: 


int x, y; 

1. if (x < y && y < z) 

printf ("x is less than z\n") ; 

2. if (x==y 1 1 x==z) 

printf ("x is equal to either y or z\n") ; 

In the first example, the printf function is called to print a message if x is less 
thany andy is less than z. If a: is greater than y, “y < z” is not evaluated and 
nothing is printed. 

In the second example, a message is printed if a: is equal to either y or z. If x 
is equal toy, “x == z” is not evaluated. 


5.3.11 Sequential Evaluation Operator 

The sequential evaluation operator (,) evaluates its two operands sequen- 
tially from left to right. The result of the operation has the value and type of 
the right operand. The types of the operands are unrestricted. No conver- 
sions are performed. 

This operator (also called the “comma” operator) is typically used to 
evaluate two or more expressions in contexts that allow only one expres- 
sion to appear. 


Examples: 


1. for (i = j = l;i + j < 20;i+=i, j--); 

2. f(x, y + 2, z); 
f((x— ,y + 2),z); 
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In the first example, each operand of the for statement’s third expression is 
evaluated independently. The left operand, “i += i,” is evaluated first, 
then “j — ” is evaluated. 

As shown in the second example, the comma character is used in other 
contexts as a separator. In the first function call, three arguments, 
separated by commas, are passed to the called function: x, “y + 2”, and z. 
The use of the comma character as a separator must not be confused with 
its use as an operator; the two functions are completely different. 

In the second function call, parentheses force the compiler to interpret the 
first comma as the sequential evaluation operator. This function call 
passes two arguments to/. The first argument is the result of the sequential 
evaluation operation “(x — , y + 2)”, which has the value and type of the 
expression “ y + 2” ; the second argument is z. 


5.3.12 Conditional Operator 

C has one ternary operator, the conditional operator (? :). Its form is: 

operand 1 ? operand 2 : operand3 

operandl is evaluated in terms of its equivalence to zero. It must have 
integral, floating-point, or pointer type. If operandl has a nonzero value, 
operandl is evaluated and the result of the expression is the value of 
operandl. If operandl evaluates to zero, operand3 is evaluated, and the 
result of the expression is the value of operand3. Notice that either 
operandl or operand3 is evaluated, but not both. 

The type of the result depends on the types of the second and third 
operands, as follows: 

1. If both the second and third operands have integral or floating- 
point type (their types can be different), the usual arithmetic 
conversions are performed. The type of the result is the type of the 
operands after conversion. 

2. Both the second and third operands can have the same structure, 
union, or pointer type. The type of the result is the same structure, 
union, or pointer type. 

3. One of the second or third operands can be a pointer and the other a 
constant-expression with the value zero. The type of the result is 
the pointer type. 


Example: 


j = (i < 0) ? (-i) : (i); 
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The above example assigns the absolute value of i to j. If i is less than zero, 
-i is assigned to j. If i is greater than or equal to zero, i is assigned to j. 


5.4 Assignment Operators 

C’s assignment operators can both transform and assign values in a single 
operation. Using a compound assignment operator to replace two 
separate operations can reduce code size and improve program efficiency. 
The assignment operators are listed and described below: 

++ Unary increment operator 

— Unary decrement operator 

= Simple assignment operator 

*= Multiplication assignment operator 

/= Division assignment operator 

%= Remainder assignment operator 

+= Addition assignment operator 

-= Subtraction assignment operator 

<<= Left shift assignment operator 

>>= Right shift assignment operator 

&= Bitwise A ND assignment operator 

|= Bitwise inclusive OR assignment operator 

a = Bitwise exclusive OR assignment operator 

In assignment, the type of the right-hand value is converted to the type of 
the left-hand value. The specific path of the conversion depends on the 
two types and is outlined in detail in Section 5.7. 


5.4.1 Lvalue Expressions 

An assignment operation specifies that the value of the right-hand 
operand is to be assigned to the storage location named by the left-hand 
operand. Thus, the left-hand operand of an assignment operation (or the 
single operand of a unary assignment expression) must be an expression 
referring to a memory location . Expressions that refer to memory locations 
are called “lvalue” expressions. A variable name is such an expression: the 
name of the variable denotes a storage location, while the value of the vari- 
able is the value residing at that location. 

The C expressions that may be lvalue expressions are: 

• identifiers of character, integer, floating-point, pointer, enumera- 
tion, structure, or union type 

© subscript ([]) expressions, except when a subscript expression 
evaluates to a pointer to an array 

© member selection expressions (-> and .), if the selected member 
is one of the above expressions 
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• unary indirection (*) expressions, except when such expressions 
refer to arrays 

• type casts to pointer types 

• an lvalue expression in parentheses 


5.4.2 Unary Increment and Decrement 

The unary assignment operators (++ and — ) increase and decrease their 
operand, respectively. The operand must have integral, floating-point, or 
pointer type, and must be an lvalue expression. 

Operands of integral or floating-point type are increased or decreased by 
the integer value 1. The type of the result is the type of the operand. An 
operand of pointer type is increased or decreased by the size of the object it 
addresses. An increased pointer points to the next object; a decreased 
pointer points to the previous object. 

An increment (++) or decrement ( — ) operator can appear either before 
or after its operand. When the operator prefixes its operand, the result of 
the expression is the increased or decreased value of the operand. When 
the operator postfixes its operand, the immediate result of the expression 
is the value of the operand before it is increased or decreased. After that 
result is noted in context, the operand is increased or decreased. 


Examples: 


1. if (pos++ > 0) 

*ptt = *qtt; 

2. if (line[ — i] != ’\n 5 ) 
return; 

In the first example, the variable pos is compared to zero, then increased by 
one. 

In the second example, the variable i is decreased before it is used as a sub- 
script to line. 


5.4.3 Simple Assignment 

The simple assignment operator (=) performs assignment. The right 
operand is assigned to the left operand; the conversion rules for assign- 
ment (discussed in Section 5.7. 1) apply. 
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Example: 


double x; 
int y; 

x = y; 

The value of yis converted to double type and assigned to x . 


5.4.4 Compound Assignment 

The compound assignment operators consist of the simple assignment 
operator combined with another binary operator. Compound assignment 
operators perform the operation specified by the additional operator, then 
assign the result to the left operand. A compound assignment expression 
such as: 

expression 1 + = expression 2 

can be understood as: 

expression 1 = expressionl + expression 2 

However, the compound assignment expression is not equivalent to the 
expanded version because the compound assignment expression evaluates 
expressionl only once, while in the expanded version expressionl is 
evaluated twice: in the addition operation and in the assignment operation. 

Each compound assignment operator performs the conversions that the 
corresponding binary operator performs, and restricts the types of its 
operands accordingly. The result of a compound assignment operation 
has the value and type of the left operand. 


Example: 


#define MASK Oxffff 
n |= MASK; 


In this example, a bitwise inclusive OR operation is performed on n and 
MASK , and the result is assigned to n. The manifest constant MASK is 
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defined with a #define preprocessor directive, discussed in Section 8.2.1 
of Chapter 8, “Preprocessor Directives”.” 


5.5 Precedence and Order of Evaluation 

The precedence and associativity of C operators affect the grouping and 
evaluation of operands in an expression. An operator’s precedence is 
meaningful only in the presence of other operators having higher or lower 
precedence. Expressions involving higher precedence operators are 
evaluated first. 

Table 5.1 summarizes the precedence and associativity of C operators. 
The operators are listed in order of precedence from the highest to the 
lowest. Where several operators appear together in a line or large brace, 
they have equal precedence and are evaluated according to their associa- 
tivity, that is, either left to right or right to left. 
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Table 5.1 

Precedence and Associativity of C Operators 


Operator 3 Symbol 

Type of Operation 

Associativity 

()[]•-> 

Expression 

Left to right 

- ~ ! * & 

++ — sizeof casts 

Unary b 

Right to left 

* / % 

Multiplicative 

Left to right 

+ - 

Additive 

Left to right 

<< >> 

Shift 

Left to right 

<><=>= 

Relational (inequality) 

Left to right 

— 1= 

Relational (equality) 

Left to right 

& 

Bitwise AND 

Left to right 


Bitwise exclusive OR 

Left to right 

1 

Bitwise inclusive OR 

Left to right 

&& 

Logical AND 

Left to right 

II 

Logical OR 

Left to right 

? : 

Conditional 

Right to left 

= *= /= % = 

+= -= <<= >> = 

&= |= ~= 

Simple and 
compound 
assignment 0 

Right to left 

f 

Sequential evaluation 

Left to right 


a Operators are listed in descending order of precedence. Where several operators 
appear in the same line or in a large brace, they have equal precedence. 

b All unary operators have equal precedence. 


c All simple and compound assignment operators have equal precedence. 

As Table 5.1 shows, operands consisting of a constant, an identifier, a 
string, a function call, a subscript expression, a member selection expres- 
sion, or a parenthetical expression have highest precedence and associate 
left to right. Type-cast conversions have the same precedence and associ- 
ativity as the unary operators. 

An expression can contain several operators with equal precedence. When 
several such operators appear at the same level in an expression, evalua- 
tion proceeds according to the associativity of the operator, either right to 
left or left to right. The result of expressions involving multiple 
occurrences of multiplication (*), addition (+), or binary bitwise (&,[,") 
operators at the same level is indifferent to the direction of evaluation. The 
compiler is free to evaluate such expressions in any order, even when 
parentheses in the expression appear to specify a particular order. 
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Only the sequential evaluation operator (,) and the logical AND (&&) and 
OR (||) operators guarantee a particular order of evaluation for the 
operands. The sequential evaluation operator (,) is guaranteed to evaluate 
its operands from left to right. 

The logical operators also guarantee to evaluate their operands left to right. 
However, the logical operators evaluate the minimum number of operands 
necessary to determine the result of the expression. Thus, some operands 
of the expression may not be evaluated. For example, in the expression “x 
&& y++” , the second operand, “y++” , is evaluated only if x is true 
(nonzero). Thus, y is not increased when x is false (zero). 

The examples below show the default grouping for several expressions: 


Examples: 

Expression 

1. a&b |c 

2. a = b | c 

3. q &&r || s — 


Default Grouping 


(a&b) ||c 
a=(b l|c) 

(q &&r) ||s- 


In the first example, the bitwise AND operator (&) has higher precedence 
than the logical OR operator (| |), so “a & b” forms the first operand of the 
logical OR operation. 


In the second example, the logical OR operator ( 1 1) has higher precedence 
than the simple assignment operator (=), so “b 1 1 c” is grouped as the 
right-hand operand in the assignment. Notice that the value assigned to a 
is either zero or one. 


The third example shows a correctly formed expression that may produce 
an unexpected result. The logical AND operator (&&) has higher pre- 
cedence than the logical OR operator (| |), so “q && r” is grouped as an 
operand. Since the logical operators guarantee evaluation of operands 
from left to right, “q && r” is evaluated before u s--”. However, if “q && 
r” evaluates to a nonzero value, “s — ” is not evaluated, and “s” is not 
decreased. To correct this problem, “s--” should appear as the first 
operand of the expression or should be decreased in a separate operation. 

The following example shows an illegal expression that produces a pro- 
gram error: 


Example: 

Illegal Expression 

p==0 ? p+= 1: p +=2 


Default Grouping 

(p == 0 ? p += 1 : p) += 2 
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In this example, the equality operator (==) has the highest precedence, so 
“p == 0” is grouped as an operand. The ternary operator (? :) has the next 
highest precedence. Its first operand is “p ==0” and its second operand is 
“p += 1”. However, the last operand of the ternary operator is considered 
to be “p” rather than “p += 2”, since this occurrence of p binds more 
closely to the ternary operator than it does to the compound assignment 
operator. A syntax error occurs because “+= 2” does not have a left-hand 
operand. 

To prevent errors of this kind, and to produce more readable code, the use 
of parentheses is recommended. The above example can be corrected and 
clarified through the use of parentheses, as shown here: 

(p==0) ? (p += 1) : (p+=2) 


5.6 Side Effects 

“Side effects” are changes in the state of the machine that take place as a 
result of evaluating an expression. Side effects occur whenever the value of 
a variable is changed. Any assignment operation has side effects, and any 
call to a function that contains assignment operations has side effects. 

The order of evaluation of side effects is implementation-dependent, 
except where the compiler guarantees a particular order of evaluation, as 
outlined in Section 5.5. 

For example, side effects occur in the following function call: 
add (i + 1, i = j + 2) 

The arguments of a function call can be evaluated in any order. The 
expression “i + 1” may be evaluated before “i = j + 2”, or vice versa, with 
different results in each case. 

Unary increment and decrement operations involve assignment and can 
cause side effects, as shown in the following example: 

d = 0; 

a = b++ = c++ = d++; 

The value of a is unpredictable. The initial value of d (zero) could be 
assigned to c, then to b , and then to a before any of the variables are 
increased. In this case a would be equal to zero. 

A second method of evaluating this expression begins by evaluating the 
operand “c++ = d++”. The initial value of d (zero) is assigned to c, and 
then both d and c are increased. Next, the increased value of c (one) is 
assigned to b and b is increased. Finally, the increased value of b is 
assigned to a. In this case, the final value of a is two. 
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Since the C language does not define the order of evaluation of side effects, 
both of these evaluation methods are correct and either can be imple- 
mented. Statements that depend on a particular order of evaluation for 
side effects produce nonportable and unclear code. 


5.7 Type Conversions 

Type conversions take place when a value is assigned to a variable of a 
different type, when a value is explicitly cast to another type, when an 
operator converts the type of its operand or operands before performing 
an operation , and when a value is passed as an argument to a function . The 
rules governing each kind of conversion are outlined below. 


5.7.1 Assignment Conversions 

In assignment operations, the type of the value being assigned is converted 
to the type of the variable receiving the assignment. C allows conversions 
by assignment between integral and floating-point types, even when the 
conversion entails loss of information. The methods of carrying out the 
conversions depend upon the type, as follows: 


Conversions from Signed Integral Types 

A signed integer is converted to a shorter signed integer by truncating the 
high-order bits and is converted to a longer signed integer by sign- 
extension. Conversion of signed integers to floating-point values takes 
place without loss of information, except that some precision can be lost 
when a long value is converted to a float. To convert a signed integer to an 
unsigned integer, the signed integer is converted to the size of the unsigned 
integer and the result is interpreted as an unsigned value. 

Conversions from signed integral types are summarized in Table 5.2. 
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Table 5.2 

Conversions from Signed Integral Types 


From 

To 

Method 

char 

short 

Sign -extend. 

char 

long 

Sign -extend. 

char 

unsigned char 

Preserve pattern; high-order bit loses function as 
sign bit. 

char 

unsigned short 

Sign-extend to short; convert short to unsigned 
short. 

char 

unsigned long 

Sign-extend to long; convert 
long to unsigned long. 

char 

float 

Sign-extend to long; convert long to float. 

char 

double 

Sign-extend to long; convert long to double. 

short 

char 

Preserve low-order byte. 

short 

long 

Sign-extend. 

short 

unsigned char 

Preserve low-order byte. 

short 

unsigned short 

Preserve bit pattern; high -order bit loses function as 
sign bit. 

short 

unsigned long 

Sign-extend to long; convert long to unsigned long. 

short 

float 

Sign-extend to long; convert long to float. 

short 

double 

Sign-extend to long; convert long to double. 

long 

char 

Preserve low- order byte. 

long 

short 

Preserve low-order word. 

long 

unsigned char 

Preserve low- order byte . 

long 

unsigned short 

Preserve low- order word. 

long 

unsigned long 

Preserve bit pattern; high-order bit loses function as 
sign bit. 

long 

float 

Represent as a float; if the long cannot be 
represented exactly, some loss of precision occurs. 

long 

double 

Represent as a double; if the long cannot be 


represented exactly as a double, some loss of preci- 
sion occurs. 


Note: The int type is equivalent either to the short type or to the long type, depending on 
the implementation. Conversion of an int value proceeds as for a short or a long, which- 
ever is appropriate. 
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Conversions from Unsigned IntegralTypes 

An unsigned integer is converted to a shorter unsigned or signed integer by 
truncating the high-order bits. An unsigned integer is converted to a 
longer unsigned or signed integer by zero-extending. Unsigned values are 
converted to floating-point values by first converting to a signed integer of 
the same size, then converting that signed value to a floating-point value. 

When an unsigned integer is converted to a signed integer of the same size, 
no change in the bit pattern occurs. However, the value represented 
changes if the sign bit is set. 

Conversions from unsigned integral types are summarized in Table 5.3. 


5-31 



C Language Reference 


Table 5.3 

Conversions from Unsigned Integral Types 


From 

To 

Method 

unsigned char 

char 

Preserve bit pattern; high-order bit 
becomes sign bit. 

unsigned char 

short 

Zero-extend. 

unsigned char 

Jong 

Zero -extend. 

unsigned char 

unsigned short 

Zero-extend. 

unsigned char 

unsigned long 

Zero-extend. 

unsigned char 

float 

Convert to long; convert long to 
float. 

unsigned char 

double 

Convert to long; convert long to 
double. 

unsigned short 

char 

Preserve low-order byte. 

unsigned short 

short 

Preserve bit pattern; high-order bit 
becomes sign bit. 

unsigned short 

long 

Zero-extend. 

unsigned short 

unsigned char 

Preserve low-order byte. 

unsigned short 

unsigned long 

Zero-extend. 

unsigned short 

float 

Convert to long; convert long to 
float. 

unsigned short 

double 

Convert to long; convert long to 
double. 

unsigned long 

char 

Preserve low-order byte. 

unsigned long 

short 

Preserve low-order word. 

unsigned long 

long 

Preserve bit pattern; high -order bit 
becomes sign bit. 

unsigned long 

unsigned char 

Preserve low-order byte. 

unsigned long 

unsigned short 

Preserve low-order word. 

unsigned long 

float 

Convert to long; convert long to 
float. 

unsigned long 

double 

Convert to long; convert long to 
double. 


Note: The unsigned int type is equivalent either to the unsigned short type or to 
the unsigned long type, depending on the implementation. Conversion of an 
unsigned int value proceeds as for an unsigned short or an unsigned long, which- 
ever is appropriate. 
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Conversions from Floating- PointTypes 

A float value converted to a double undergoes no change in value. A dou- 
ble converted to a float is represented exactly, if possible. If the value is too 
large to fit into a float, precision is lost. 

A floating-point value is converted to an integer value by converting to a 
long. Conversions to other integer types take place as for a long. The 
decimal portion of the floating-point value is discarded in the conversion 
to a long. If the result is still too large to fit into a long, the result of the 
conversion is undefined. 

Conversions from floating-point types are summarized in Table 5.4: 

Table 5.4 

Conversions from Floating- PointTypes 


From 

To 

Method 

float 

char 

Convert to long; convert long to char. 

float 

short 

Convert to long; convert long to short. 

float 

long 

Truncate at decimal point; if result is too large 
to be represented as a long, result is 
undefined. 

float 

unsigned short 

Convert to long; convert long to unsigned 
short. 

float 

unsigned long 

Convert to long; convert long to unsigned 
long. 

float 

double 

Change internal representation. 

double 

char 

Convert to float; convert float to char. 

double 

short 

Convert to float; convert float to short. 

double 

long 

Truncate at decimal point; if result is too large 
to be represented as a long, result is 
undefined. 

double 

unsigned short 

Convert to long; convert long to unsigned 
short. 

double 

unsigned long 

Convert to long; convert long to unsigned 
long. 

double 

float 

Represent as a float; if the double value can- 
not be represented exactly as a float, loss of 
precision occurs; if the value is too large to be 
represented in afloat, the result is undefined. 
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Conversions from Other Types 

An enum value is an int value, by definition of the enum type. Conversions 
to and from an enum value proceed as for the int type. An int is equivalent 
to either a short or a long, depending on the implementation. 

No conversions between structure or union types are allowed. 

A pointer value behaves like an unsigned integer value in conversions, with 
the size of the pointer determined by the implementation. Conversions to 
and from a pointer type proceed as for an unsigned integer of the appropri- 
ate size, except that pointers cannot be converted to floating-point types. 

A pointer to one type of value can be converted to a pointer to a different 
type. The result may be undefined, however, because of the alignment 
requirements and sizes of different types in storage. In some implementa- 
tions the near and far keywords modify pointer sizes. Conversions 
between near and far pointers may produce meaningless addresses. 

The void type has no value, by definition. Therefore, it cannot be con- 
verted to any other type, nor can any value be converted to void by assign- 
ment. However, a value can be explicitly cast to void, as discussed in Sec- 
tion 5.7.2. 


5.7.2 Type- Cast Conversions 

Explicit type conversions can be made by means of a type cast. A type cast 
has the form: 

(type- name)operand 

where type- name specifies a particular type and operand is a value to be 
converted to the specified type. (Type names are discussed in Section 4.9 
of Chapter 4, “Declarations”.”) 

The conversion of operand takes place as though it had been assigned to a 
variable of the named type. The conversion rules for assignments (out- 
fined in Section 5.7.1) apply to type casts as well. The type name void can 
be used in a cast operation, but the resulting expression cannot be assigned 
to any item. 


5.7.3 Operator Conversions 

The conversions performed by C operators depend on the operator and on 
the type of the operand and operands. Many operators perform the “usual 
arithmetic conversions, ” which are outlined in Section 5.3.1. 
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C permits some arithmetic with pointers. In pointer arithmetic, integer 
values are converted to express memory positions. See the discussions of 
additive operators (Section 5.3.6) and subscript expressions (Section 
5.2.5) for details. 


5.7.4 Function- Call Conversions 

The type of conversion performed on the arguments in a function call 
depends on whether a forward declaration with declared argument types is 
present for the called function . 

If a forward declaration is present, and it includes declared argument 
types, the compiler performs type-checking. The type-checking process 
is outlined in detail in Section 7.4.1 of Chapter 7, “Functions”.” 

If no forward declaration is present, or if the forward declaration omits the 
argument type list, the only conversions performed on the arguments in the 
function call are the usual arithmetic conversions. These conversions are 
performed independently on each argument in the call. This means that a 
float value is converted to a double; a char or short value is converted to an 
int; and an unsigned char or unsigned short is converted to an unsigned 
int. 
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Statements 


6.1 Introduction 

The statements of a C program control the flow of program execution. In 
C, as in other programming languages, several kinds of statements are 
available to perform loops, to select other statements to be executed, and 
to transfer control. This chapter describes C statements in alphabetical 
order, as follows: 
break statement 
compound statement 
continue statement 
do statement 
expression statement 
for statement 
goto statement 
if statement 
null statement 
return statement 
switch statement 
while statement 

C statements consist of keywords, expressions, and other statements. 

The keywords that appear in C statements are: 


break 

do 

if 

case 

else 

return 

continue 

for 

switch 

default 

goto 

while 


The expressions in C statements are the expressions discussed in Chapter 
5, “Expressions and Assignments”. ” Statements appearing within C 
statements may be any of the statements discussed in this chapter. 

A statement that forms a component of another statement is called the 
“body” of the enclosing statement. Frequently the statement body is a 
“compound” statement (i.e., a single statement), is composed of one or 
more statements. 

The compound statement is delimited by braces. All other C statements 
end with a semicolon. 

Any C statement may be prefixed with an identifying label consisting of a 
name and a colon. Statement labels are recognized only by the goto state- 
ment and are therefore discussed with the goto statement. 

When a C program is executed, its effect is that of the execution of the 
statements in order of their appearance in the program, except where a 
statement explicitly transfers control to another location. 
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6.2 Break Statement 


Syntax 


break; 


Execution 

The break statement terminates the execution of the smallest enclosing 
do, break, switch, or while statement in which it appears. Control passes 
to the statement following the terminated statement. A break statement 
appearing outside any do, for, switch, or while statement causes an error. 

Within nested statements, the break statement terminates only the do, 
for, switch, or while statement immediately enclosing it. To transfer con- 
trol out of the nested structure altogether, a return or goto statement can 
be used. 


Example: 


for (i = 0; i < LENGTH - 1; i++) { 
for G =0; j < WIDTH - 1 ; j++) { 
if (lines[i][j] == ’\0’) { 
lengths[i] = j; 
break; 


} 


The above example processes an array of variable length strings stored in 
lines. The break statement causes an exit from the interior for loop after 
the terminating null character (\0) of each string is found and stored in 
lengths[i\. Control then returns to the outer for loop. The variable i is 
increased and the process is repeated until i is greater than or equal to 
LENGTH- 1. 


6-2 



Statements 


6.3 Compound Statement 


Syntax 


{ 

[declaration] 


statement 

[statement] 


} 


Execution 

All statements within a compound statement are executed in the order of 
their appearance. The single exception to this is where one of the state- 
ments causes a logical branch. 


Example: 


if (i > 0) { 
line[i] = x; 
x++; 
i--; 

} 

A compound statement typically appears as the body of another state- 
ment such as the if statement. In the above example, if i is greater than 
zero, all of the statements in the compound statement are executed in 
order. 


Labeled Statements 

Like other C statements, any of the statements in a compound statement 
may carry a label. Transfer into the compound statement by means of a 
goto is therefore possible. However, transferring into a compound state- 
ment is dangerous when the compound statement includes declarations 
that initialize variables. Declarations in a compound statement precede 
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the executable statements, so transferring directly to an executable state- 
ment within the compound statement bypasses the initializations. The 
results are unpredictable. 


6.4 Continue Statement 


Syntax 


continue; 


Execution 

The continue statement passes control to the next iteration of the do, for, 
or while statement in which it appears, bypassing any remaining state- 
ments in the do, for, or while statement body. Within a do or a while state- 
ment, the next iteration begins with the reevaluation of the do or while 
statement’s expression. Within a for statement, the next iteration starts 
with the evaluation of the for statement’s loop- expression. It proceeds 
with the evaluation of the conditional expression and subsequent termi- 
nation or reiteration of the statement body. 


Example: 


while (i— > 0) { 
x = f(i); 
if (x == 1) 
continue; 
y = x *x; 

} 

The statement body is executed if i is greater than zero. First, “f(i)” is 
assigned to x. Then, if x is equal to 1, the continue statement is executed. 
The rest of the statements in the body are ignored, and execution resumes 
at the top of the loop with the evaluation of “i — > 0”. 
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6.5 Do Statement 


Syntax 


do 

statement 

while ( expression ); 


Execution 

The body of a do statement is executed one or more times until expression 
becomes false. First, the statement body is executed. Then expression is 
evaluated. If expression is false (zero), the do statement terminates and 
control passes to the next statement in the program. If expression is true 
(nonzero), the statement body is executed again, and expression is tested 
again. The statement body is executed repeatedly until expression 
becomes false. 

The do statement may also terminate with the execution of a break, goto, 
or return statement within the statement body. 


Example: 


do{ 

y=f(x); 

x—; 

} while (x> 0); 

The two statements “y = f(x);” and “x— are executed, regardless of the 
initial value of x. Then “x > 0” is evaluated. If x is greater than zero, the 
statement body is executed again and “x > 0” is reevaluated. The state- 
ment body is executed repeatedly so long as x remains greater than zero. 
Execution of the do statement terminates when x becomes zero or nega- 
five. 
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6.6 Expression Statement 


Syntax 


expression ; 


Execution 

The expression is evaluated, according to the rules outlined in Chapter 5, 
“Expressions and Assignments”.” 


Examples: 


1. x=(y + 3); 

2. x++; 

3. f(x); 

In C, assignments are expressions; the value of the expression is the value 
being assigned (sometimes called the “right-hand value”). In the first 
example, x is assigned the value of “y + 3”. In the second example, x is 
increased by 1. 

The third example shows a function call expression. The value of the 
expression is the value, if any, returned by the function. If a function 
returns a value, the expression statement usually incorporates an assign- 
ment to store the returned value when the function is called. If the return 
value is not assigned, as in the example, the function call is executed but 
the return value, if any, is not used. 
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6.7 ForStatement 


Syntax 


for ( [init- expression]-, [ cond- expression ] ; [loop- expression ) ) 
statement ; 


Execution 

The body of a for statement is executed zero or more times until the 
optional cond- expression becomes false. The init- expression and loop- 
expression are optional expressions that can be used to initialize and 
modify values during the for statement’s execution. 

The first step in the execution of the for statement is the evaluation of 
init- expression , if present. Next, cond- expression is evaluated, with three 
possible results: 

1. If the conditional expression is true (nonzero), the statement body 
is executed ; then loop- expression , if present, is evaluated ; then the 
process begins again with the evaluation of cond- expression. 

2. If the conditional expression is omitted, the conditional expres- 
sion is considered true; execution proceeds exactly as described 
above. A for statement lacking cond- expression terminates only 
upon the execution of a break, goto, or return statement within the 
statement body. 

3. If the conditional expression is false, execution of the for state- 
ment terminates and control passes to the next statement in the 
program. 

A for statement may also terminate with the execution of a break, return, 
or goto statement within the statement body. 


Example: 


for (i = space = tab = 0; i < MAX; i++) { 
if(line[i]==’\0x20’) 
space++; 
if (linefi] == ’\t’) { 
tab++; 

line[i]=’\0x20’; 

> 

> 


6-7 



C Language Reference 


The above example counts space (\0x20) and tab (\t) characters in the 
array of characters named line and replaces each tab character with a 
space. First, i, space , and tab are initialized to zero. Then i is compared 
to the constant MAX; if i is less than MAX , the statement body is exe- 
cuted. Depending on the value of line[i], the body of one or neither of the 
if statements is executed. Then i is increased and tested against MAX . 
The statement body is executed repeatedly as long as i is less than MAX. 


6.8 Goto and Labeled Statements 


Syntax 


goto name; 


name: statement 


Execution 

The goto statement transfers control directly to the statement specified by 
name. The labeled statement is executed immediately after the goto state- 
ment is executed. An error results if no statement with the given label 
resides in the same function or if an identical label appears before more 
than one statement in the same function. 

A statement label is meaningful only to a goto statement. When a labeled 
statement is encountered in any other context, the statement is executed 
without regard to the label. 


Example: 


if (errorcode > 0) 
goto exit; 


exit: 

return (errorcode); 
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In the example, a goto statement transfers control to the point labeled exit 
when an error occurs. 


Forming Labels 

A label name is simply an identifier, formed by following the same rules 
that govern the construction of identifiers (see Section 2.4 of Chapter 2, 
“Elements of C”). Each statement label must be distinct from other 
statement labels and identifiers in the same function. 


6.9 IfStatement 


Syntax 


if ( expression ) 

statementl 

[else 

statementl ] 


Execution 

The body of an if statement is executed selectively, depending on the 
value of expression. First, expression is evaluated. If expression is true 
(nonzero), the statement immediately following it is executed. If expres- 
sion is false, the statement following the else keyword is executed. If 
expression is false and the else clause is omitted, the statement following 
expression is ignored. Control then passes from the if statement to the 
next statement in the program. 
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Example: 


if (i > 0) 
y = x/i; 
else { 
x = i; 
y = f(x); 

> 

In the example, the statement “y = x/i;” is executed if i is greater than 
zero. If i is less than or equal to zero, i is assigned to x and “f(x)” is 
assigned to y. Notice that the statement forming the if clause ends with a 
semicolon. 


Nesting 

C does not offer an “else if” statement, but the same effect is achieved by 
nesting if statements. An if statement may be nested in either the if clause 
or the els e clause of another if statement. 

When nesting if statements and els e clauses, use braces to group the state- 
ments and clauses into compound statements that clarify your intent. In 
the absence of braces, the compiler resolves ambiguities by pairing each 
else with the most recent if lacking an else. 


Examples: 


1. if (i > 0) /* Without braces */ 

if (j > i) 

x = j; 
else 
x = i; 


2. if (i > 0) { /* With braces */ 

if G > i) 

x = j; 

} 

else 
x = i; 

hi the first example, the else is associated with the inner if statement. If i 
is less than or equal to zero, no value is assigned to x. 
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In the second version, the braces surrounding the inner if statement make 
the els e clause part of the outer if statement. If i is less than or equal to 0, i 
is assigned to x. 


6.10 NullStatement 


Syntax 


Execution 

A null statement is a statement containing only a semicolon. It may 
appear wherever a statement is expected. Nothing happens when a null 
statement is executed . 


Example: 


for (i = 0; i < 10; line[i++] = 0) 


Statements such as do, for, if, and while require that an executable state- 
ment appear as the statement body. The null statement satisfies the syn- 
tax requirement in cases that do not need a substantive statement body. 
In the above example, the third expression of the for statement initializes 
the first ten elements of line to zero. The statement body is a null state- 
ment, since no further statements are necessary. 


Labeling a NullStatement 

The null statement, like any other C statement, may be prefixed by an 
identifying label. To label an item that is not a statement, such as the clos- 
ing brace of a compound statement, you can insert and label a null state- 
ment immediately before the item to get the same effect. 
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6.11 Return Statement 


Syntax 


return [expression]] 


Execution 

The return statement terminates the execution of the function in which k 
appears and returns control to the calling function. Execution resumes in 
the calling function at the point just after the call. The value of expression , 
if present, is returned to the calling function. If expression is omitted, the 
return value of the function is undefined. 


Example: 


main() 

{ 


y = sq(x); 
draw(x, y); 


} 

sq(x) 

intx; 

{ 

return (x* x); 

} 

void draw(x,y) 
intx, y; 

{ 


return ; 

} 
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The main{) function calls two functions, sq{) and draw. () The sq{) func- 
tion returns the value of “x * x” to main. () The return value is assigned to 
y. The drawQ function is declared as a void function and does not return 
a value. An attempt to assign the return value of draw{) would cause an 
error. 

By convention, parentheses enclose the expression of the return state- 
ment, as shown above. The language does not require the parentheses. 


Omitting the Return Statement 

If no return statement appears in a function definition, control automati- 
cally returns to the calling function after the last statement of the called 
function. The return value of the called function is undefined. If a return 
value is not required, the function should be declared to have void return 
type. 
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6.12 Switch Statement 


Syntax 


switch ( expression ) { 
[declaration] 


[case constant - expression :] 


[statement] 


[default : 

statement ] 

[case constant- expression :] 


[statement] 


y 


Execution 


The switch statement transfers control to a statement within its body. 
The statement receiving control is the statement whose case constant - 
expression matches the value of the expression in parentheses. Execution 
of the statement body begins at the selected statement and proceeds 
through the end of the body or until a statement transfers control out of 
the body. 

The default statement is executed if no case constant- expression is equal 
to the value of the switch expression. If the default statement is omitted, 
and no case match is found, none of the statements in the switch body are 
executed. 
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The switch expression must be an integral or enum value. If the expres- 
sion is shorter than an int, it is widened to an int value. Each case 
constant- expression is then cast to the type of the switch expression. The 
value of each case constant- expression must be unique within the state- 
ment body. 

The case and default labels of the switch statement body are significant 
only in the initial test that determines the starting point for execution of 
the statement body. All statements appearing between the statement 
where execution starts and the end of the body are executed regardless of 
their labels, unless a statement transfers control out of the body entirely. 

Declarations may appear at the head of the compound statement forming 
the switch body, but initializations included in the declarations are not 
performed. The effect of the switch statement is to transfer control 
directly to an executable statement within the body, bypassing the lines 
that contain initializations. 


Examples: 


1. switch (c) { 

case ’A’: 

capa++; 
case ’a 5 : 

lettera++; 
default : 
total++; 

> 

2. switch (i) { 

case -1: 
n++; 
break; 
caseO: 
z++; 
break; 
case 1 : 

P++; 

break; 

} 

In the first example, all three statements of the switch body are executed if 
c is equal to VI * . Execution control is transferred to the first statement 
(“capa++;”) and continues in order through the rest of the body. If c is 
equal to V, lettera and total are increased. Only total is increased if c is 
not equal to A * or l a \ 
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In the second example, a break statement follows each statement of the 
switch body. The break statement forces an exit from the switch after one 
statement in the body is executed. If i is equal to -1, only n is increased. 
The break following the statement “n++;” causes execution control to 
pass out of the switch body, bypassing the remaining statements. Simi- 
larly, if i is equal to 0, only z is increased; if i is equal to 1, only p is 
increased. The final break statement is not strictly necessary, since con- 
trol will pass out of the body at the end of the compound statement, but it 
is included for consistency. 


Multiple Labels 

A statement may carry multiple case labels, as the following sample 
shows: 

case ’a’ : 
case V : 
case ’c’ : 
case ’d’ : 
case V : 

case T : hexcvt(c); 

Although any statement within the body of the switch statement may be 
labeled, no statement is required to carry a label. Statements without 
labels may be freely intermingled with labeled statements. Keep in mind, 
however, that once the switch statement passes control to a statement 
within the body, all succeeding statements in the block are executed, 
regardless of their labels. 


6.13 While Statement 


Syntax 


while ( expression ) 
statement 


Execution 

The body of a while statement is executed zero or more times until expres- 
sion becomes false. First, expression is evaluated. If the expression is ini- 
tially false (zero), the body of the while statement is never executed, and 
control passes from the while statement to the next statement in the pro- 
gram. If expression is true (nonzero), the body of the statement is 
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executed. Following each execution of the statement body, expression is 
reevaluated. The body is executed repeatedly as long as expression 
remains true. 

The while statement may also terminate with the execution of a break, 
goto, or return within the statement body. 


Example: 


while (i > = 0) { 

stringl[i] = string2[i]; 

i— ; 

> 

The above example copies characters from string2 to stringl. If i is greater 
than or equal to zero, string2[i\ is assigned to stringl[i] and i is decreased. 
When i reaches or falls below 0, execution of the while statement ter- 
minates. 
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7.1 Introduction 

A function is an independent collection of declarations and statements, 
usually designed to perform a specific task. C programs have at least one 
main function and may have other functions. The sections of this chapter 
describe how to define, declare, and call C functions. 

A function definition specifies the name of the function, its formal parame- 
ters, and the declarations and statements that define its action. The func- 
tion definition can also give the return type of the function and its storage 
class. 

A function declaration establishes the name, return type, and storage class 
of a function whose explicit definition is given at another point in the pro- 
gram. The number and types of arguments to the function can also be 
specified in the function declaration. This allows the compiler to compare 
the types of the actual arguments and the formal parameters of a function. 
Function declarations are optional for functions whose return type is int. 
To ensure correct behavior, functions with other return types must be 
declared before they are called . 

A function call passes execution control from the calling function to the 
called function. The actual arguments, if any, are passed by value to the 
called function. Execution of a return statement in the called function 
returns control and possibly a value to the calling function. 


7.2 Function Definitions 

A function definition specifies the name, formal parameters, and body of a 
function. It may also define the function’s return type and storage class. A 
function definition has the following form: 

sc- specifier ][ type- specifier ] declarator ( [parameter- list ] ) 
parameter- declarations] 
function - body 

The sc- specifier gives the function’s storage class, which must be either 
static or extern. The type- specifier and declarator together specify the 
function’s return type and name. The parameter- list is a list (possibly 
empty) of formal parameters to be used by the function. The parameter- 
declarations establish the types of the formal parameters. The function- 
body is a compound statement containing local variable declarations and 
statements. The following sections describe the parts of the function 
definition in detail. 
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7.2.1 Storage Class 

The storage class specifier in a function definition gives the function either 
static or extern storage class. A function with static storage class is visible 
only in the source file in which it is defined. All other functions, whether 
they are given extern storage class explicitly or implicitly, are visible 
throughout all the source files that constitute the program . 

The storage class specifier is required in a function definition in only one 
case: when the function is declared elsewhere in the same source file with 
the static storage class specifier. 

The static storage class specifier can also be used when defining a function 
previously declared in the same source file without a storage class specifier. 
Normally, a function declared without a storage class specifier defaults to 
the extern class. However, if the function definition explicitly specifies the 
static class, the function is given static class instead. 

When the storage class specifier is omitted from a function definition, the 
storage class defaults to extern. The extern storage class specifier can be 
explicitly specified in the function definition, but it is not required. 


7.2.2 Return Type 

The return type of a function defines the size and type of value returned by 
the function . The type declaration has the form : 

[ type- specifier ] declarator 

where type- specifier, together with the declarator , define the function’s 
return type and name. If no type- specifier is given, the return type int is 
assumed. 

The type- specifier can specify any fundamental, structure, or union type. 
The declarator consists of the function identifier, possibly modified to 
declare a pointer type. Functions cannot return arrays or functions, but 
they can return pointers to any type, including arrays and functions. 

The return type given in the function definition must match the return type 
in declarations of the function elsewhere in the program. Functions with 
int return type do not have to be declared before they are called. Functions 
with other return types cannot be called before they are either defined or 
declared. 

A function’s return value type is used only when the function returns a 
value. A function returns a value when a return statement containing an 
expression is executed. The expression is evaluated, converted to the 
return value type if necessary, and returned to the point of call. If no 
return statement is executed, or if the executed return statement does not 
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contain an expression, the return value of the function is undefined. If the 
calling function expects a return value, the b ehavior of your program is also 
undefined. 


Examples: 


1 . /* return type is int */ 
static add (x, y) 

intx, y; 

{ 

return (x+y); 

} 

2. typedef struct { 
char name[20]; 
int id; 

long class; 

} STUDENT; 

/* return type is STUDENT */ 
STUDENT sortstu (a, b) 
STUDENT a, b; 

{ 

return ( (a. id < b.id) ? a : b ); 

} 


3. /* return type is char pointer */ 
char *smallstr(sl, s2) 
charsl[], s2[ ]; 

{ 

inti; 

i-0; 

while ( sl[i] != ’\0’ && s2[i] != ’\0’ ) 
i++; 

if ( sl[i] == 5 \0’) 
return (si); 
else 

return (s2); 

} 

In the first example, the return type of add is int by default. The function 
has static storage class, which means it can be called only by functions in 
the same source file. 
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The second example defines the STUDENT type with a typedef declara- 
tion and defines the function sortstu( ) to have STUDENT return type. The 
function selects and returns one of its two structure arguments. 

The third example defines a function returning a pointer to an array of 
characters. The function takes two character arrays (strings) as arguments 
and returns a pointer to the shorter of the two strings. A pointer to an array 
points to the type of the array elements. Thus, the return type of the func- 
tion is pointer to char. 


7.2.3 Formal Parameters 

Formal parameters are variables that receive values passed to a function by 
a function call. The formal parameters are declared in a parameter list at 
the beginning of the function declaration. The parameter list defines the 
names of the parameters and the order in which they take on values in the 
function call. 

The parameter list has the form : 

( [ identifier [, identifier ] ] .. . ) 

where each identifier names a parameter. The parentheses are required. 

Parameter declarations define the type and size of values stored in the for- 
mal parameters. These declarations have the same form as other variable 
declarations (see Section 4.4 of Chapter 4, “Declarations”). A formal 
parameter can have any fundamental, structure, union, pointer, or array 
type. 

A parameter can only have auto or register storage class. If no storage 
class is given, auto storage is assumed. If a formal parameter is named in 
the parameter list but is not declared, the parameter is assumed to have int 
type. Formal parameters can be declared in any order. 

The identifiers of the formal parameters are used in the function body to 
refer to the values passed to the function. These identifiers cannot be used 
for variable declarations within the function body. 

The type of the formal parameter should correspond to the type of the 
actual argument and to the type of the corresponding argument in the argu- 
ment type list for the function, if present. If the function has a variable 
number of arguments, the user is responsible for determining the number 
of arguments passed and for retrieving additional arguments from the stack 
within the body of the function. 

The compiler performs the usual arithmetic conversions independently on 
each formal parameter and on each actual argument, if necessary. After 
conversion, no formal parameter is shorter than an int, and no formal 
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parameter has float type. This means, for example, that declaring a formal 
parameter as a char has the same effect as declaring it an int. 

The converted type of each formal parameter determines how the argu- 
ments placed on the stack by the function call are interpreted. A type 
mismatch between an actual and a formal parameter can cause the argu- 
ments on the stack to be misinterpreted. For example, if a 16-bit pointer is 
passed as an actual argument, then declared as a long formal parameter, 
the first 32 bits on the stack are stored in the long formal parameter. This 
error creates problems not only with the long formal parameter, but with 
any formal parameters that follow it. Errors of this kind can be detected 
through diligent use of argument type lists in function declarations. 


Example: 


struct student { 
char name[20]; 
int id; 
longclass; 

struct student *nextstu ; 

} student; 

main() 

{ 

int match ( struct student *, char * ); 


if (match (student. nextstu, 
student. name) > 0) { 


>’ 

} 

match (r, n ) 
struct student *r; 
char *n; 

{ 

int i = 0; 

while (r->name[i]==n[i]) 
if ( r->name[i++] == ’\0’ ) 
return (r->id); 
return (0); 
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The example contains a structure type declaration, a forward declaration 
of the function match(), a call to match , and the definition of the match{) 
function. Notice that the same name, student , can be used without conflict 
both for the structure tag and for the structure variable name. 

The match{) function is declared to have two arguments, the first a pointer 
to the student structure type and the second a pointer to a char type. 

The two formal parameters of the match{ ) function are r and n. The 
parameter r is declared as a pointer to the student structure type. The 
parameter n is declared as a pointer to a char type. 

The function is called with two arguments, both members of the student 
structure. Because there is a forward declaration of match , the compiler 
performs type-checking between the actual arguments and the argument 
type list and between the actual arguments and the formal parameters. 
Since the types match, no warnings or conversions are necessary. 

Note that the array name given as the second argument in the call evaluates 
to a char pointer. The corresponding formal parameter is also declared as 
a char pointer, and is used in subscripted expressions as though it were an 
array identifier. Since an array identifier evaluates to a pointer expression, 
the effect of declaring the formal parameter as char **n is the same as 
declaring it char n[ ]. 

Within the function, the local variable i is defined and used to keep track of 
the current position in the array. The function returns the id structure 
member if the name member matches the array n. Otherwise, it returns 
zero. 


7.2.4 Function Body 

The function body is simply a compound statement. The compound state- 
ment contains the statements that define the function’s action and can also 
contain declarations of variables used by these statements. See Section 6.3 
of Chapter 6, “Statements”, for a discussion of compound statements. 

All variables declared in the function body have auto storage type unless 
otherwise specified. When the function is called, storage space for the 
local variables is created and local initializations are performed. Execution 
control passes to the first statement in the compound statement and con- 
tinues sequentially until a return statement or the end of the function body 
is encountered. Control then passes back to the point of call. 

A return statement containing an expression must be executed if the func- 
tion is to return a value. The return value of a function is undefined if no 
return statement is executed or if the return statement does not include the 
optional expression . 
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7.3 Function Declarations 

A function declaration defines the name, return type, and storage class of a 
given function, and may establish the type of some or all of the function’s 
arguments. See Chapter 4, “Declarations”, for a detailed description of 
the syntax of function declarations. 

Functions can be declared implicitly or with forward declarations. The 
return type of a function declared either implicitly or with a forward 
declaration must agree with the return type specified in the function 
definition. 

An implicit declaration occurs whenever a function is called without being 
previously defined or declared. The C compiler implicitly declares the 
function to have int return type. By default, the function is declared to 
have extern storage class. The function definition can redefine the storage 
class to static, provided the function definition is given later in the same 
source file. 

A forward declaration establishes the attributes of a function, allowing the 
declared function to be called before it is defined or to be called from 
another source file. If the storage class specifier static is given in a forward 
declaration, the function has static class. The function definition must 
also specify the static class. If the storage class specifier is extern or is omit- 
ted, the function has extern class. However, the function definition can 
redefine the storage class as static, provided the function definition 
appears below the declaration in the same source file. 

Forward declarations have several important uses. They establish the 
return type for functions that return any type of value but int. (Functions 
that return int values can also have forward declarations, but do not 
require them.) Functions with non-int return types cannot be called before 
they are either declared or defined; the compiler assumes that the called 
function has int return type. 

Forward declarations can be used to establish the types of arguments 
expected in a function call. The optional argument type list of a forward 
declaration gives the type and number of arguments expected. (The 
number of arguments can be variable.) The argument type list is a list of 
type names corresponding to the expression list in the function call. 

If no argument type list is supplied, no type-checking is performed. Type 
mismatches between actual arguments and formal parameters are silently 
accepted . Type-checking is discussed further in Section 7.4. 1. 
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Forward declarations are also used to declare pointers to functions before 
the functions are defined. 


Example: 


main() 

{ 

inta = 0, b = l; 

floatx = 2.0, y = 3.0; 

double realadd(double, double); 

a = intadd (a, b); 
x = realadd(x, y); 

> 

intadd(a, b) 
int a, b; 

{ 

return (a + b); 

} 

double realadd(x, y) 
double x, y; 

{ 

return (x + y); 

> 

In the example, the function intadd ( ) is implicitly declared to return an int 
value, since it is called before it is defined. The compiler does not check 
the types of the arguments in the call because no argument type list is avail- 
able. 

The function realadd ( ) returns a double value instead of an int. The for- 
ward declaration of realadd in the main ( ) function allows the realadd ( ) 
function to be called before it is defined. Notice that the definition of 
realadd() matches the forward declaration by specifying the double return 
type. 

The forward declaration of realadd() also establishes the type of its two 
arguments. The actual arguments match the types given in the forward 
declaration and also match the types of the formal parameters. 
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7.4 Function Calls 

A function call is an expression that passes control and zero or more actual 
arguments to a function. A function call has the form : 

expression ( expression - list) 

where expression evaluates to a function address and expression- list is a list 
of expressions whose values, the actual arguments, are passed to the func- 
tion. The expression- list can be empty. 

When the function call is executed, the expressions in the function expres- 
sion list are copied, converted as necessary, and then passed to formal 
parameters of the called function. The first expression in the list always 
corresponds to the first formal parameter of the function, the second 
expression corresponds to the second formal parameter, and so on 
through the end of the list. Since the called function works with copies of 
the actual arguments, any changes it makes to the arguments are not 
reflected in the original values from which the copies were made. 

Execution control then passes to the first statement in the function. The 
execution of a return statement in the body of the function returns control 
and possibly a value to the calling function. If no return statement is exe- 
cuted, control returns to the caller after the last statement of the called 
function is executed. The return value is undefined . 

The expressions in the function call’s expression list can be evaluated in 
any order, so expressions with side effects have unpredictable results. The 
only guarantee the compiler makes is that all side effects in the expression 
list are evaluated before control passes to the called function. 

The only requirement in calling a function is for the expression before the 
parentheses to evaluate to a function address. This means that a function 
can be called through any function pointer expression. It maybe helpful to 
remember that a function is called in the same manner it is declared. For 
instance, when declaring a function, the name of the function is given, fol- 
lowed by an argument type list in parentheses. To call the function, only 
the name of the function is required, followed by an expression list in 
parentheses. The indirection operator ( is not required to call the func- 
tion; the name of the function evaluates to the function address, which is 
used to call the function. 

The same principle applies when calling a function through a pointer. For 
example, suppose a function pointer is declared as follows: 

int (*fpointer)(int, int); 
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The identifier /pointer is declared to point to a function taking two int argu- 
ments and returning an int value. A function call through fpointer might 
look like this: 

(*fpointer)(3,4) 

The indirection operator ( is used to obtain the address of the function to 
which fpointer points. The function address is then used to call the func- 
tion. 


Examples: 


1. double *realcomp(double, double); 
double a, b, *rp; 


rp = realcomp(a, b); 

2. main () 

longlift(int), step(int), drop(int); 
void work (int, long (*)(int)); 
int select, count; 


select = 1; 
switch ( select ) { 

case 1: work (count, lift); 
break; 

case 2: work(count, step); 
break; 

case 3: work(count, drop); 

default: 

break; 

} 

> 
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void work ( n , func ) 
intn; 

long(*func)(int); 

{ 

int i; 
long j; 

for (i = j = 0; i < n; *i++) 
j += (*func)(i); 

} 

In the first example, the realcompO function is called in the statement rp = 
realcomp(a, b);. Two double arguments are passed to the realcomp ( ) 
function. The return value, a pointer to a double, is assigned to rp. 

In the second example, the function call: 

work (count, lift); 

in main ( ) passes an integer variable and the address of the function lift ( ) to 
the function workQ. Notice that the function address is passed simply by 
giving the function identifier, since a function identifier evaluates to a 
pointer expression. To use a function identifier in this way, the function 
must be declared or defined before the identifier is used. Otherwise, the 
identifier is not recognized. In this case, a forward declaration for workQ 
is given at the beginning of the mainQ function. 

The formal parameter func in workQ is declared to be a pointer to a func- 
tion taking one int argument and returning a long. The parentheses around 
the parameter name are required; without them, the declaration would 
specify a function returning a pointer to a long. 

The function workQ calls the selected function by using the function call: 
(*func)(i); 

One argument, i, is passed to the called function. 


7.4.1 Actual Arguments 

An actual argument can be any value with fundamental, structure, union, 
or pointer type. Although arrays and functions cannot be passed as param- 
eters, pointers to these items can be passed. 

All actual arguments are passed by value. A copy of the actual argument is 
assigned to the corresponding formal parameter. The function uses this 
copy without affecting the variables from which it was originally derived. 
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Pointers provide a way to access a value by reference from a function. 
Since a pointer to a variable holds the address of the variable, the function 
can use this address to access the value of the variable. Pointer arguments 
allow a function to access arrays and functions, even though arrays and 
functions cannot be passed as arguments. 

Each expression in a function call is evaluated and converted as follows. If 
an argument type list for the called function is available, the usual arith- 
metic conversions are performed independently on each expression in the 
expression list and on each type in the argument type list. Each expression 
in the expression list is then compared with the type name that occupies the 
corresponding position in the argument type list. The value of the expres- 
sion is converted (if necessary) to the named type as if by assignment. 

Next, the converted expression is compared with the type of the formal 
parameter that has the same place in the parameter list as the expression 
has in the expression list. (The formal parameters also undergo the usual 
arithmetic conversions before the comparison.) No conversions are per- 
formed, but the compiler produces warning messages as if the expressions 
were assigned to the formal parameters. 

The number of expressions given in the expression list must match the 
number of formal parameters, unless the function’s forward declaration 
explicitly specifies a variable number of arguments. In this case, the com- 
piler checks as many arguments as there are type names in the argument 
type list and converts them, if necessary, as described above. If there are 
additional actual arguments in the function call, each additional argument 
undergoes the usual arithmetic conversions, but is not otherwise converted 
or checked. 

If the argument type list contains the special type name void, the compiler 
expects zero actual arguments in the function call and zero formal parame- 
ters. It produces a warning message if it finds otherwise. 

If the argument type list is empty (omitted) or the called function has no 
forward declaration, the compiler performs no type-checking, either for 
type or for number of arguments. In this case, the actual arguments in the 
function call, if any, undergo the usual arithmetic conversions indepen- 
dently before they are placed on the stack. 

The type of each formal parameter also undergoes the usual arithmetic 
conversions. The converted type of each formal parameter determines 
how the arguments on the stack are interpreted. If the type of the formal 
parameter does not match the type of the actual argument, the data on the 
stack can be misinterpreted. 

Type mismatches between actual and formal parameters can produce seri- 
ous errors, particularly when the mismatches entail size differences. Keep 
in mind that these errors are not detected unless an argument type list is 
given in the forward declaration of the function. 
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Example: 


main () 

{ 

void swap (int *, int *); 
int x, y; 


swap(&x, &y); 

} 

void swap (a, b) 
int *a, *b; 

{ 

intt; 

t = *a; 

*a = *b; 

*b = t; 

} 

In the above example, the swap() function is declared in main ( ) to have 
two arguments, both pointers to integers. The formal parameters a and b 
are also declared as pointers to integer variables. In the function call: 

swap (&x, & y) 

the address of x is stored in a and the address ofy is stored in b. There are 
two names, or aliases, for the same location . References to * *a and * *b in 
swap are effectively references to x and y in mainQ. The assignments 
within swap change the contents of x andy. 

The compiler performs type-checking on the arguments to swap because 
an argument type list is present in the forward declaration of swap. The 
types of the actual arguments match both the argument type list and the for- 
mal parameters. 


7.4.2 Calls with a Variable Number of Arguments 

To call a function with a variable number of arguments, the programmer 
simply gives any number of arguments in the function call. In the forward 
declaration of the function (if there is one), a variable number of argu- 
ments is specified by placing a comma at the end of the argument type list 
(see Section 4.5 of Chapter 4, “Declarations”). One argument must be 
present in the function call for each type name specified in the argument 
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type list. If only a comma (but no type names) is given, no arguments are 
required when calling the function. Refer to varargs(F) in the XENIX 
Reference Manual for information on using variable arguments lists. 

All the arguments given in the function call are placed on the stack. The 
number of formal parameters declared for the function determines how 
many of the arguments are taken from the stack and assigned to the formal 
parameters. The programmer is responsible for retrieving any additional 
arguments from the stack and for determining how many arguments are 
present. 


Example: 


main() 

{ 

int scores (int, ); 
int count, average, i; 


average = scores (count, 14, 96, 82); 


> 

scores (number) 
int number; 

{ 

int*ip, total = 0, i; 
ip = &number + 1; 

for (i = 1; i <= number; i++, ip++) 
total += *ip; 


if (number > 0) 

return (total/number); 
return (-1); 

} 

The above example shows a function named scores () that takes a variable 
number of arguments. The forward declaration of scores in mainf) estab- 
lishes that scoresf) has at least one argument, an int. The comma at the end 
of the argument type list means that there may be more undeclared argu- 
ments. 
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In the call to scores , four actual arguments are passed. The first argument is 
checked for compatibility with the argument type list and the formal 
parameter of scores. Since the types match, no conversions or warning 
messages are necessary. 

In the definition of the scores{) function, one formal parameter is 
declared. The additional arguments are retrieved by taking the address of 
the previous argument {number in the first case), increasing it, and retriev- 
ing the value at that address. This procedure works because arguments 
passed to a function are stored in order on the stack. 

The number argument is assumed to hold the number of additional argu- 
ments, so its value controls how many additional arguments are retrieved 
from the stack. When number arguments have been retrieved and added to 
the total, the average of the scores is returned to the main function. The 
value -1 is returned if number is zero. 


7.4.3 Recursive Calls 

Any function in a C program can be called recursively. A function can 
therefore call itself. The C compiler allows any number of recursive calls 
to a function. On each call, new storage is allocated for the formal parame- 
ters and for the auto and register variables so that their values in previous, 
unfinished calls are not overwritten. Previous parameters are inaccessible 
to all versions of the function except the version in which they were 
created. 

Notice that variables declared with global storage do not require new 
storage with each recursive call. Their storage exists for the lifetime of the 
program. Each reference to such a variable accesses the same storage area. 

Although the C compiler defines no limit on the number of times a func- 
tion can be called recursively, the operating environment may impose a 
practical limit. Since each recursive call requires additional stack memory, 
too many recursive calls can cause a stack overflow. 
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Preprocessor Directives 


8.1 Introduction 

The C preprocessor is a text processor used to manipulate the text of a 
source file before compilation. The compiler ordinarily invokes the 
preprocessor in its first pass, but the preprocessor can also be invoked 
separately to process text without compiling. This chapter explains the 
main tasks performed by preprocessor directives and describes each direc- 
tive in detail. 

Preprocessor directives are typically used to make source programs easy to 
modify and to compile in different execution environments. Directives in 
the source file instruct the preprocessor to perform specific actions. For 
example, the preprocessor can replace tokens in the text, insert the con- 
tents of other files into the source file, and suppress compilation of a por- 
tion of the filebyremovingblocksof text. 

The C preprocessor recognizes the following directives: 


define #ifdef 

elif #ifndef 

else #include 

endif #line 

if #undef 


The number sign (#) must be the first nonwhitespace character on the line 
containing the directive. Whitespace characters can appear between the 
number sign and the first letter of the directive. Some directives are fol- 
lowed by arguments or values, as described below. Directives can appear 
anywhere in a source file, but they apply only to the remainder of the 
source file in which they appear. 


8.2 Manifest Constants and Macros 

The #define directive is typically used to associate meaningful identifiers 
with constants, keywords, and commonly used statements or expressions. 
Identifiers that represent constants are called “manifest constants.” 
Identifiers that represent statements or expressions are called “macros.” 

Once an identifier is defined, it cannot be redefined to a different value 
without first removing the definition. However, the identifier can be 
redefined with exactly the same definition. Thus, a program is allowed to 
contain more than one occurrence of the same definition . 
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The #undef directive removes the definition of an identifier. Once the 
definition has been removed, the identifier can be redefined to a different 
value. Sections 8.2.1 and 8.2.2 discuss the #define and #undef directives 
respectively. 

Macros can be defined to look and act like function calls. Because macros 
do not generate actual function calls, replacing function calls with macros 
can improve execution time. However, macros create problems if they are 
not defined and used with care. Macro definitions with arguments may 
require the use of parentheses to preserve the proper precedence in an 
expression. In addition, macros may not handle expressions with side 
effects correctly. See the examples in Section 8.2. 1 for details. 


8.0.1 Define Directive 


Syntax 


#define identifier text 

#define identifier ( parameter - list ) text 

The #define directive substitutes the given text for subsequent occurrences 
of the specified identifier in the source file. The identifier is replaced only 
when it forms a token. (Tokens are described in Chapter 2, “Elements of 
C,” and in Appendix B.) For instance, the identifier is not replaced when it 
occurs within strings or as part of a longer identifier. 

If a parameter- list appears after the identifier, the #define directive 
replaces each occurrence of identifier {argument- list) with a version of text 
modified by substituting actual arguments for formal parameters. 

The text consists of a series of tokens, such as keywords, constants, or 
complete statements. One or more whitespace characters must separate 
the text from the identifier (or from the closing parenthesis of the 
parameter- list). If the text is longer than one line, it can be continued onto 
the next line by preceding the newline character with a b ackslash (\). 

The text can also be empty. The effect of this option is to remove instances 
of the given identifier from the source file. The identifier is still considered 
defined, however, and yields the value 1 when tested with the #if directive 
(discussed later in this chapter). 

The parameter- list, when given, consists of one or more formal parameter 
names separated by commas. Each name in the list must be unique, and 
the list must be enclosed in parentheses. No spaces between the identifier 
and the opening parenthesis are allowed. 
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Formal parameter names appear in text to mark the places where actual 
values will be substituted. Each parameter name can occur more than 
once in the text, and the names can appear in any order. 

The actual arguments following an instance of the identifier in the source 
file are matched to the formal parameters of the parameter - list, and the text 
is modified by replacing each formal parameter with the corresponding 
actual argument. The actual argument- list and the formal parameter- list 
must have the same number of arguments. 

Arguments with side effects sometimes cause macros to produce unex- 
pected results. A macro definition may contain more than one occurrence 
of a given formal parameter. If that formal parameter is replaced by an 
expression with side effects, the expression, with its side effects, is 
evaluated more than once (see Example 4 b elow) . 


Examples: 


1. #define WIDTH 80 

#define LENGTH (WIDTH + 10) 

2. #define FILEMESSAGE "Attempt to create \ 
file failed because of insufficient space" 

3. #defineREGl register 
#defineREG2 register 
#defineREG3 

4. #define MAX(x,y) ((x) > (y)) ? (x) : (y) 

5. #define MULT(a,b) ((a)*(b)) 

The first example defines the identifier WIDTH as the integer constant 80, 
and defines LENGTH in terms of WIDTH and the integer constant 10. 
Each occurrence of LENGTH is replaced with “(WIDTH + 10), ” which is 
in turn replaced with the expression “(80 + 10).” The parentheses around 
“WIDTH + 10” are important because they control the interpretation in a 
statement such as the following: 

var = LENGTH *20; 

After the preprocessing stage the statement becomes: 

var = (80 + 10) * 20; 
or 1800. 
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Without parentheses, the result is: 
var=80+ 10*20; 

which evaluates to 280 because the multiplication operator (**) has higher 
precedence than the addition operator (+). 

The second example defines the identifier FILEMESSAGE . The 
definition is extended to a second line by using the backslash escape char- 
acter (\). 

The third example defines three identifiers, REG1, REG2 , and REG3. 
REG1 and REG2 are defined as the keyword register. The definition of 
REG3 is empty, so each occurrence of REG3 is removed from the source 
file. These directives can be used to ensure that the program’s most impor- 
tant variables (declared with REG1 and REG2) are given register storage. 
See the discussion of the #if directive later in Section 8.4.1 for an 
expanded version of this example. 

The fourth example defines a macro named MAX. Each occurrence of the 
identifier MAX following the definition in the source file is replaced by the 
expression “((x) > (y)) ? (x) : (y),” where actual values replace the parame- 
ters x and y. For example, the occurrence: 

MAX(1,2) 

is replaced with: 

((1) > (2)) ? (1) : (2) 

and the occurrence: 

MAX(i,s[i]) 

is replaced with: 

((0>(s[i]))?(i):(s[i]) 

This macro is easier to read than the corresponding expression, making the 
source program easier to understand. 

Notice that arguments with side effects may cause this macro to produce 
unexpected results. For example, the occurrence “MAX(i, s[i++])” is 
replaced with “((i) > (s[i++])) ? (i) : (s[i++])’\ The expression “(s[i++])” is 
evaluated twice, so by the time the ternary expression has been fully 
evaluated, i has increased by two. The result of the ternary expression is 
unpredictable, since the operands of the ternary expression can be 
evaluated in any order, and the value of i varies depending on the evalua- 
tion order. 
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The fifth example defines the macro MULT . Once the macro is defined, an 
occurrence such as “MULT(3, 5)” is replaced by “(3) ** (5)” The 
parentheses around the parameters are important because they control the 
interpretation when complex expressions form the arguments to the 
macro. For instance, the occurrence “MULT(3 + 4, 5 + 6)” is replaced by 
“(3 + 4) ** (5 + 6)” which evaluates to 77. Without the parentheses, the 
result is “3 + 4 ** 5 + 6,” which evaluates to 29 because the multiplication 
operator (**) has higher precedence than the addition operator (+). 


8.2.2 Undefine Directive 


Syntax 


#undef identifier 

The #undef directive removes the current definition of identifier. The 
preprocessor ignores subsequent occurrences of identifier. To remove a 
macro definition using #undef, give only the macro identifier. Do not give 
a parameter list. 

The #undef directive is typically paired with a #define directive to create a 
region in a source program in which an identifier has a special meaning. 
For example, a specific function of the source program can use manifest 
constants to define environment-specific values that do not affect the rest 
of the program . The #undef directive also works with the #if directive (see 
Section 8.4. 1) to control compilation of portions of the source program. 


Example: 


#define WIDTH 80 
#define ADD(X,Y) (X) + (Y) 


#undef WIDTH 
#undef ADD 

In this example, the #undef directive removes definitions of a manifest 
constant and a macro. Note that only the identifier of the macro is given. 
The #undef directive can also be applied to an identifier that has no previ- 
ous definition. This ensures that the identifier is undefined. 
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8.3 Include Files 


Syntax 


#include pathname 
#include < pathname > 

The #include directive adds the contents of a given “include fUe” to 
another file. Constant and macro definitions can be organized into include 
files and added to any source file by using #include directives. Include files 
are also useful for incorporating declarations of external variables and 
complex data types. The types need only be defined and named once in an 
include file created for that purpose. 

The #include directive tells the preprocessor to treat the contents of the 
named file as if they appeared in the source program at the point of the 
directive. The new text can also contain preprocessor directives. The 
preprocessor carries out directives in the new text, then continues process- 
ing the original text of the source file. 

The pathname is a filename optionally preceded by a directory 
specification. It must name an existing file. The syntax of the file 
specification depends on the specific operating system on which the pro- 
gram is compiled. 

The preprocessor uses the concept of a “standard” directory or directories 
to search for included files. The location of the standard directories for 
include files depends on the implementation and the operating system. 
See your system documentation for a definition of the standard direc- 
tories. 

The preprocessor stops searching as soon as it finds a file with the given 
name. If a complete, unambiguous pathname for the include file is given, 
either in double quotation marks ("") or in angle brackets (< >), the 
preprocessor searches only that pathname and ignores the standard direc- 
tories. 

If the file specification does not give a complete pathname, and the file 
specification is enclosed in double quotation marks, the preprocessor 
searches for the file in the same directory as the including file first (the 
“current working directory”). It then searches directories specified in the 
compiler command line and finally searches the standard directories. 

If the file specification is enclosed in angle brackets, the preprocessor does 
not search the current working directory. It begins by searching for the file 
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in directories specified in the compiler command line and then searches 
the standard directories. 

An #include directive can be nested. In other words, the directive can 
appear in a file named by another #include directive. When the preproces- 
sor encounters the nested #include directive, it processes the named file 
and inserts it into the current file. The preprocessor uses the same search 
procedures outlined above in searching for nested include files. 

The new file can also contain #include directives. Nesting can continue up 
to ten levels. Once the nested #include is processed, the preprocessor 
continues to insert the enclosing include file into the original source file. 


Examples: 


1. #include <stdio.h> 

2. #include "defs.h" 

The first example adds the contents of the file named stdio.h to the source 
program. The angle brackets cause the preprocessor to search the stan- 
dard directories for stdio.h, after searching directories specified in the 
command line. 

The second example adds the contents of the file specified by defs.h to the 
source program. The double quotation marks mean that the directory con- 
taining the current source file is searched first. 


8.4 Conditional Compilation 

This section describes the syntax and use of directives that control “condi- 
tional compilation.” These directives allow for suppressing compilation of 
portions of a source file. They test a constant-expression or an identifier to 
determine which text blocks are passed on to the compiler and which are 
removed from the source file in the preprocessing stage. 
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8.4. 1 If, Elif, Else, and Endif Directives 


Syntax 


#if restricted- constant- expression 
[ text ] 

[ #elif restricted- constant- expression 
text ] 

[ #elif restricted- constant- expression 
text ] 


[#else 

text] 

#endif 

The #if directive, together with the #elif, #else, and #endif directives, 
controls compilation of portions of a source file. Each #if directive in a 
source file must be matched by a closing #endif directive. Zero or more 
#elif directives can appear between the #if and #endif directives, but at 
most one #else directive is allowed. The #else directive, if present, must 
be the last directive b efore #endif. 

The preprocessor selects one of the given blocks of text for further process- 
ing. A text block is any sequence of text. It can occupy more than one line. 
Usually the text block is program text that has meaning to the compiler or 
the preprocessor. However, this is not a requirement; the preprocessor 
can be used to process any kind of text. 

The selected text is processed by the preprocessor and passed to the com- 
piler. If the text contains preprocessor directives, those directives are car- 
ried out. 

Any text blocks not selected by the preprocessor are removed from the file 
in the preprocessing stage and are therefore not compiled. 

The preprocessor selects a single text block by evaluating the restricted- 
constant- expressions following each #if or #elif directive until a true 
(nonzero) restricted- constant- expression is found. All text between the 
first true restricted- constant- expression and the next number sign (#) is 
selected. 

If no restricted- constant- expression is true, or if there are no #elif direc- 
tives, the preprocessor selects the text after the #else clause. If the #else 
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clause is omitted, and no restricted- constant- expression in the #if block is 
true, no text is selected. 

Each restricted- constant- expression follows the rules for restricted- 
constant-expressions discussed in Section 5.2.10 of Chapter 5, “Expres- 
sions and Assignments”. Such expressions cannot contain sizeof expres- 
sions, type casts, or enumeration constants, but they can contain the spe- 
cial constant-expression “dGf\nQd(identifier)” This constant-expression 
is considered true (nonzero) if the given identifier is currently defined. Oth- 
erwise, the condition is false (zero). An identifier defined as empty text is 
considered defined. 

The #if, #elif, #else, and #endif directives can nest in the text portions of 
other #if directives. When nested, each #else, #elif, and #endif directive 
belongs to the closest preceding #if directive. 


Examples: 


1. #if defined(CREDIT) 

credit(); 

#elif defined(DEBIT) 
debit(); 

#else 

printerrorQ; 

#endif 

2. #if DLEVEL > 5 

#define SIGNAL 1 
#if STACKUSE== 1 

#define STACK 200 

# e lse 

#define STACK 100 
#endif 
# e lse 

#define SIGNAL 0 
#if STACKUSE== 1 

#define STACK 100 

# e j se 

#define STACK 50 
#endif 
#endif 
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3. #if DLEVEL == 0 

#define STACK 0 
#elif DLEVEL == 1 
#define STACK 100 
#elif DLEVEL >5 
display( debugptr ) ; 

# e l se 

#define STACK 200 
#endif 

4. #defineREGl register 
#defineREG2 register 

#if defined(M_86) 

#define REG3 
#define REG4 
#define REGS 
#else 

#define REG3 register 
#ifdefined(M_68000) 
#define REG4 register 
#define REG5 register 
#endif 
#endif 


In the first example, the #if and #endif directives control compilation of 
one of three function calls. The function call to credit is compiled if the 
identifier CREDIT is defined. If the identifier DEBIT is defined, the func- 
tion call to debit is compiled. If neither identifier is defined, the call to prin- 
terror is compiled. Note that CREDIT and credit are distinct identifiers in 
C b ecause their cases are different. 

The next two examples assume a previously defined manifest constant, 
DLEVEL. The second example shows two sets of nested #if, #else, and 
#endif directives. The first set of directives is processed only if “DLEVEL 
> 5” is true. Otherwise, the second set is processed. 

In the third example, #elif and #else directives are used to make one of 
four choices, based on the value of DLEVEL. The manifest constant 
ST A CK is set to 0, 100, or 200, depending on the definition of DLEVEL. If 
DLEVEL is not defined, “display( debugptr );” is compiled and STACK is 
not defined. 

The fourth example uses preprocessor directives to control the meaning of 
register declarations in a portable source file. The compiler assigns regis- 
ter storage to variables in the same order in which the register declarations 
appear in the source file. If a program contains more register declarations 
than the machine can accommodate, the compiler honors earlier declara- 
tions over later ones. Loss of efficiency can occur if the variables declared 
later are more heavily used . 
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The definitions listed above can be used to give priority to the most impor- 
tant register declarations. REG1 and REG2 are defined as the register key- 
word to declare regis ter storage for the two most important variables in the 
program. For example, in the following fragment, b and c have higher 
priority than aord: 

func(a) 

REG3 int a; 

{ 

REG1 intb; 

REG2 int c ; 

REG4 int d ; 


} 

When M_86 is defined, the preprocessor removes the REG3 identifier from 
the file by replacing it with empty text. This prevents a from receiving 
register storage at the expense of b and c. When M_68000 is defined, all 
four variables are declared to have register storage. When neither M_86 
nor MJ58000 is defined, a, b, and c are declared with register storage. 


8.4.2 Ifdef and Ifndef Directives 


Syntax 


#ifdef identifier 
#ifndef identifier 

The #ifdef and #ifndef directives accomplish the same task as the #if 
directive used with “defined (identifier) ” These directives can be used any- 
where #if can be used. These directives are provided only for compatibil- 
ity with previous versions of the language. The “ &Q£inQd.(identifier)” 
constant-expression used with the #if directive is preferred. 

When the preprocessor encounters an #ifdef directive, it checks to see 
whether the identifier is currently defined. If so, the condition is true 
(nonzero). Otherwise, the condition is false (zero). 

The #ifndef directive checks for exactly the opposite condition checked 
by #ifdef. If the identifier has not been defined (or its definition has been 
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removed with #undef), the condition is true (nonzero). Otherwise, the 
condition is false (zero). 


8.5 Line Control 


Syntax 


#line constant [ "filename" ] 

The #line directive instructs the preprocessor to change the compiler’s 
internally stored line number and filename to a given line number and 
filename. The compiler uses the internally stored line number and 
filename to refer to errors encountered during compilation. The line 
number normally refers to the current input line; the filename refers to the 
current input file. The line number is increased after each line is pro- 
cessed. 

Changing the line number and filename causes the compiler to ignore the 
previous values and to continue processing with the new values. The #line 
directive is typically used by program generators to cause error messages to 
refer to the original source file instead of the generated program . 

The constant value in the #line directive is any integer constant. The 
filename can be any combination of characters. It must be enclosed in dou- 
ble quotation marks (""). If filename is omitted, the previous filename 
remains unchanged. 

The current line number and filename are always available through the 

predefined identifiers LINE and FILE . The LINE and 

— FILE — identifiers can be used to insert self-descriptive error messages 
into the program text . 


Examples: 


1. #line 151 "copy.c" 

2. #define ASSERT(cond) if(!cond)\ 
{printfC assertion error line %d, file(%s)\n", \ 
_ JLINE__, FILE );} else ; 


In the first example, the internally stored line number is set to 151 and the 
filename is changed to copy.c. 
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In the second example, the macro ASSERT uses the predefined identifiers 

“ LINE ” and “ FILE ” to display an error message about the 

source file if a given “assertion” is not true. 
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Differences 


A. 1 Introduction 

This appendix summarizes differences between Microsoft C and the 
description of the C language found in Appendix A of The C Programming 
Language by Brian W. Kemighan and Dennis M. Ritchie, published in 
1978 by Prentice-Hall, Inc. The differences are listed with cross- 
references to the corresponding section numbers in The C Programming 
Language . 



2.3 


2.4.1 

2.4.3 


2.6 

4 


Microsoft C 

Identifiers (including those used in preproces- 
sor directives) are significant to 31 characters. 
External identifiers are also significant to 31 
characters. 

The identifiers asm and entry are no longer 
keywords. New keywords are const, enum and 
void. (The const keyword is not yet imple- 
mented but is reserved for future use.) The 
identifiers far, fortran, huge, near, and pascal 
may be keywords, depending on whether the 
corresponding options are enabled when a pro- 
gram is compiled (see your system documenta- 
tion). 

Hexadecimal and octal constants are treated as 
unsigned values and are not sign-extended in 
type conversions. 

Hexadecimal bit patterns consisting of a 
backslash (\), the letter “x,” and up to two hex- 
adecimal digits are permitted as character con- 
stants (for example, \xl2). 

Microsoft C defines two additional escape 
sequences: the sequence \v represents a verti- 
cal tab (VT), and the sequence V represents 
the double quote character. 

Character constants always have type char, 
with the result that they are sign-extended in 
type conversions. 

The short type is always 16 bits in length, the 
long type 32 bits. The size of an int is machine 
dependent. On 8086/8088 processors an int is 
16 bits long, and on 68000 machines it is 32 bits. 
The char type is signed, with the result that a 
char value is sign -extended in type conver- 
sions. 

Two additional unsigned types are supported: 

unsigned char and unsigned long. 
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6.5 

6.6 


7.2 
7.14 

8.2 


8.4 

8.5 


8.6 

9.7 

12 


Microsoft C offers an additional fundamental 
type, the enum (enumeration) type. The void 
type is defined as the return type of functions 
that do not return a value. 

The keyword unsigned can be applied as an 
adjective to any integer type (char, int, short, 
or long). When unsigned stands alone, it is 
taken to mean unsigned int. 

The arithmetic conversions carried out by the 
Microsoft C Compiler are outlined in Sections 
5.3.1 and 5.7 of Chapter 5, “Expressions and 
Assignments”. Although compatible with the 
Kemighan and Ritchie conversions, the 
Microsoft C conversions are spelled out in 
greater detail, including the specific path for 
each type of conversion. 

In connection with the sizeof operator, a byte 
is defined as an 8-bit quantity. 

A structure can be assigned to another struc- 
ture of the same type. 

The keywords enum and void are additional 
type specifiers. Additional acceptable combi- 
nations are unsigned char, unsigned short, 
unsigned short int, unsigned long, and 
unsigned long int. 

Optional argument type lists can be included in 
function declarations to notify the compiler of 
the number and types of arguments expected in 
a function call. 

Bitfields must be declared unsigned. 

The names of structure and union members are 
not required to be distinct from structure and 
union tags or from the names of other vari- 
ables. 

No relationship exists between the members of 
two different structure types. 

Unions can be initialized by giving a value for 
the first member of the union. 

The expression of a switch statement has enum 
or integral type. Each of the case constant- 
expressions is cast to the type of the expression . 
The number sign (#) introducing the prepro- 
cessor directive can be preceded by any combi- 
nation of whitespace characters. Whitespace 
can also occur between the number sign and 
the preprocessor keyword . 
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The new combination #if defined {identifier) is 
intended to supplant the #ifdef and #ifndef 
directives. Use of the latter directives is 
discouraged. 

The new directive #elif (else-if) is designed for 
use in #if and #if defined blocks. 

A structure or union can be assigned to 
another structure or union of the same type. 
Structures and unions can be passed by value 
to functions and returned by functions. 

In expressions involving “-> the expression 
before the arrow must have the same type (or 
be cast to the same type) as the structure to 
which the member on the right-hand side of 
the arrow belongs. 

The listed anachronisms are not recognized. 
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B.l Tokens B-l 

B.1.1 Keywords B-l 
B.1.2 Identifiers B-l 
B.1.3 Constants B-2 
B.1.4 Strings B-4 
B.1.5 Operators B-4 
B.1.6 Separators B-5 

B.2 Expressions B-5 

B.3 Declarations B-7 

B.4 Statements B-10 

B.5 Definitions B-ll 

B.6 Preprocessor Directives B-ll 
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B.l Tokens 


keyword 

identifier 

constant 

string 

operator 

separator 


B.1.1 Keywords 


auto 

default 

float 

register 

switch 

break 

do 

for 

return 

typedef 

case 

double 

goto 

short 

union 

char 

else 

if 

sizeof 

unsigned 

constf 

enum 

int 

static 

void 

continue 

extern 

long 

struct 

while 


The following identifiers may be keywords, depending on whether the 
corresponding option is enabled when the program is compiled. See your 
system documentation for details. 

far 

fortran 

huge 

near 

pascal 


B.l. 2 Identifiers 


identifier : 
letter 

underscore 
identifier letter 
identifier underscore 
identifier digit 


t Not yet implemented. 
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letter : one of: 

abcdefghijklm 

nopqrstuvwxyz 

ABCDEFGHIJKLM 

NOPQRSTUVWXYZ 


underscore : 


digit: one of: 
0123456789 


B.1.3 Constants 


constant: 

integer- constant 
long- constant 
floating- point- constant 
char - constant 
enum- constant 


integer - constant: 

0 

decimal- constant 
octal- constant 
hexadecimal- constant 


decimal - constant: 
nonzero- digit 
decimal- constant digit 


nonzero- digit: one of: 
123456789 


octal- constant: 

Ooctal- digit 

octal- constant octal- digit 


octal- digit: one of: 
01234567 
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hexadecimal - constant : 

0 ^hexadecimal- digit 
OXhexadecimal- digit 
hexadecimal- constant hexadecimal- digit 


hexadecimal- digit : one of: 
0123456789 
ab c def 
ABCDEF 


long- constant : 

integer- constant 1 
integer- constant L 


floating- point- constant: 

fractional- constant exponent 
fractional - constant 
digit- seq exponent 


fractional- constant : 
digit- seq . digit- seq 
. digit- seq 
digit- seq. 


digit- seq: 
digit 

digit - seq digit 


exponent : 

e sign digit- seq 
E sign digit- seq 
e digit- seq 
E digit- seq 


sign: 

+ 


char- constant: 
1 char ’ 
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char : 

rep - char 
escape - sequence 


rep- char : 

Any single representable character except the single quote (’), 
backslash (\), or newline character. 


escape- sequence: one of: 

V \ \\ \ddd \xddd \b 

\f \n \r \t \v 


enum- constant: 
identifier 


B.1.4 Strings 


string - literal: 
char- seq 

char-seq: 

char 

char- seq char 


B.1.5 Operators 


operator: one of: 


1 


++ 

— 

+ 

- 

* 

/ 

o/ 

/o 

<< 

>> 

< 

<= 

> 

>== 

&& 

!= 

ii 

1 

& 

+= 

__ 

*_ 

/= 

%= 

>>= 

<< = 

&= 

*= 

h 

?; 

j 

[] 

0 


-> 
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B.1.6 Separators 

separator : one of: 

[ ] ( ) { } 

* , : = ; # 

B.2 Expressions 

In this section (B.2), the brackets shown are part of the syntax for the 
language and should be interpreted literally. 

expression : 
identifier 
constant 
string 

expression{expression- list) 
expression {) 
expression [expression ] 
expression . identifier 
expression-> identifier 
unary - expression 
binary - expression 
ternary- expression 
assignment- expression 
{expression) 

{type- name)expression 
constant- expression 


expression- list : 
expression 

expression- list, expression 


unary- expression : 
u/zo/7 expression 
size of {expression) 


unop: one of: 
- ~ ! * & 


B-5 



C Language Reference 


lvalue : 
identifier 

expression[expression\ 
expression . expression 
expressions expression 
* expression 

( type - name)expression 
(i lvalue ) 


type- name: 

See Section B. 3, “Declarations.” 


binary - expression : 

expression binop expression 


binop : one of: 


* 

/ 

0/ 

/o 

+ 

- 

<< 

>> 

< 

> 

< 

>= 

&& 

!= 

'll 

& 

y 

1 


ternary- expression : 

expression ? expression : expression 


assignment- expression : 

/vfl/we — 

++/vtf/uc 

--lvalue 

lvalue assignment- op expression 


assignment- op: one of: 


<<= 


*= 

>>= 


/= 

&= 


%= 

h 
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constant- expression : 
identifier 
constant 

{type- name)constant- expression 
unary- expression 
binary- expression 
ternary- expression 
{constant- expression) 


B.3 Declarations 

In this section (B.3), the brackets shown are part of the syntax for the 
language and should be interpreted literally. 

declaration : 

sc- specifier type- specifier declarator- list ; 
type- specifier declarator- list ; 
sc- specifier declarator- list ; 
type- specifier) 

typedef type- specifier declarator- list ; 


sc- specifier: 

auto 

extern 

register 

static 
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type- specifier: 

char 

double 

enum- specifier 

float 
int 
long 
long int 
short 
short int 
struct- specifier 
typedef- name 
union- specifier 
unsigned 
unsigned char 
unsigned int 
unsigned long 
unsigned long int 
unsigned short 
unsigned short int 


enum- specifier: 

enum tag {enum- list } 
enum {enum- list } 
enum tag 


tag: 

identifier 

enum- list: 
enumerator 
enum- list , enumerator 


enumerator: 

identifier 

identifier = constant- expression 


struct- specifier: 

struct tag {member- declaration- list } 
struct {member- declaration- list } 
struct rag 


member- declaration- list: 
member- declaration 

member- declaration- list member- declaration 
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member- declaration : 

type- specifier declarator- list ; 

type- specifier identifier : constant- expression ; 

type- specifier : constant - expression ; 


declarator- list : 
declarator 

declarator = initializer 
declarator- list , declarator 


declarator : 
identifier 
declarator[ ] 

declarator[constant- expression] 
* declarator 
declarator ( ) 
declarator(arg - type- list ) 

(< declarator ) 


rg- type- to: 
type- mzrae 

a rg- type- to, type- rame 
flrg- type- to, 

void 

void* 


type- name: 
type- specifier 

type- specifier abstract - declarator 


abstract- declarator: 

* 

[] 

(flrg- type- to) 

* abstract- declarator 

abstract- declarator * 

abstract- declarator[ ] 

abstract - declarator[constant- expression ] 

[ ]abstract- declarator 

[constant- expression]abstract- declarator 

abstract- declarator ( ) 

abstract- declarator(arg- type- list ) 

( abstract - declarator) 
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initializer : 
expression 
{initializer- list } 


initializer- list : 
initializer 

initializer- list , initializer 


typedef- name: 
identifier 


union- specifier: 

union tag {member- declaration- list} 
union {member- declaration- list} 
union tag 


B.4 Statements 

In this section (B.4), brackets enclose optional portions of the syntax. 

statement: 

break; 

case constant - expression : statement 

compound- statement 

continue; 

default : statement 

do sta temen t while ( expression ); 

expression ; 

for {[expression]: [expression];[expression])statement; 

goto identifier ; 

identifier : statement 

if {expression) statement [else statement] 

y 

return [expression]; 
switch {expression) statement 
while {expression) statement 


compound- statement: 

{[declaration- list] [statement- list]} 


declaration- list: 
declaration 

declaration- list declaration 
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statement - list : 
statement 

statement- list statement 


B.5 Definitions 

In this section (B.5), brackets enclose optional portions of the syntax. 

definition : 

function- definition 
data- definition 


function- definition : 

[sc- specifier ] [type- specifier] declarator ([ parameter - to]) 
[ parameter - decs] compound- statement 


parameter- list : 
identifier 

parameter- list , identifier 


parameter- decs: 
declaration 

declaration- list declaration 


data- definition: 
declaration 


B.6 Preprocessor Directives 

In this section (B.6), brackets enclose optional portions of the syntax. 
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directive : 

# 

#define identified ( \parameter- list ] ) ] [token- seq\ 

#elif restricted- constant - expression 

#else 

#endif 

#if restricted- constant- expression 
#ifdef identifier 
#ifndef identifier 
#include <string> 

#include string 
#line digit- seq 
#line digit- seq string 
#undef identifier 


token- seq: 
token 

token- seq token 


restricted- constant- expression : 
defined (identifier) 

Any constant- expression except for sizeof expressions, 
casts, and enumeration constants. 
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> (right shift) operator 5-16 
! (logical not) operator 5-11 
!= (inequality) operator 5-17 

* (number sign) A-2 

* character 8-1 
#define directive 8-2 
#elif defined (identifier) 

#elif directive 

#elif directive 8-8, A-3 
#else directive 8-8 
#endif directive 8-8 
#if defined A-3 
#if defined (identifier) 

#if directive 
#if directive 8-8 
#ifdef directive 8-11, A-3 
#ifndef directive 8-11, A-3 
#include directive 8-6 
#line directive 8-12 
#undef directive 8-5 
% (remainder) operator 5-13 
& (address-of) operator 5-11 
& (bitwise AND) operator 5-18 
8l& (logical AND) operator 5-19 
( ) (parentheses) in function call expressions 
5-3 

() (parentheses), in expressions 5-8 

* (asterisk), as pointer modifier 4-5 

* (asterisk), in declarations 4-18 
+ (addition) operator 5-14 

++ (increment) operator 5-23 
, (comma), in arg-type-list 4-20 
, (sequential evaluation) operator 5-20 
. (period) in member selection expressions 5-6 
/ (division) operator 5-13 
< (relational) operator 5-17 
<< (left shift) operator 5-16 
<= (relational) operator 5-17 
(angle brackets), in #include directive 8-6 

= (simple assignment) operator 5-23 
== (equality) operator 5-17 
(relational) operator 5-17 
= (relational) operator 5-17 
? : (conditional) operator 5-21 
[ ] in subscript expressions 5-3 
[ ] (brackets), as array modifier 4-5 
[ ] (brackets), in array declarations 4-16 

- (arithmetic negation) operator 5-10 

- (subtraction) operator 5-14 

(arrow) in member selection expressions 5-6, 
5-6 

(member selection) operator A-3 

- (decrement) operator 5-23 
\ character 

see backslash (\) character 

* (indirection) operator 5-11 

* (multiplication) operator 5-13 

- (bitwise exclusive OR) operator 5-18 
__FTLE__ identifier 8-12 


LINE identifier 8-12 

{} (braces), in initialization 4-30 
| (bitwise inclusive OR) operator 5-18 
|| (logical OR) operator 5-20 
~ (bitwise complement) operator 5-10 


A 


Abstract declarator 4-35 
Actual arguments 7-11 
Actual arguments, conversion 7-12 
Actual arguments, order of evaluation 7-9 
Actual arguments, passing 7-11 
Actual arguments, pointer 7-9, 7-12 
Actual arguments, side effects 7-9 
Actual arguments, type-checking 7-12 
Actual arguments, variable number 7-13 
Addition operator (+) 5-14 
Addition, with pointers 5-15 
Additive operations, with pointers 5-15 
Additive operators 5-14 
Address-of (&) operator 5-11 
Aggregate types 4-1 
Aggregate types, array 4-16 
Aggregate types, initialization 4-29, 4-30 
Anachronisms A-3 
AND operator, bitwise (&) 5-18 
AND operator, logical (&&) 5-19 
Angle brackets (<), in #include directive 8-6 
arg-type-list 4-20 
argc parameter 3-5 
Argument type list 7-7, A-2 
Argument type list, void * 4-21 
Argument type list, void keyword 4-21 
Argument type, declaring 7-7 
Argument type-checking 4-21 
argument -type -list, with abstract declarator 
4-35 

Arguments 7-11 
Arguments, actual 
Actual arguments 7-9 
Arguments, command line 3-5 
Arguments, conversion of 7-12 
Arguments, formal 
Parameters, formal 7-4 
Arguments, order of evaluations 7-9 
Arguments, passing 7-11 
Arguments, pointer 7-9, 7-12 
Arguments, side effects 7-9 
Arguments, to main function 3-5 
Arguments, type-checking 7-12 
Arguments, variable number 4-20, 7-13 
argv parameter 3-5 
Arithmetic conversions 5-9, A-2 
Arithmetic negation (-) operator 5-10 
Arithmetic, with pointers 5-15 
Array declarations 4-16 
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Array elements, referring to 5-3 
Array identifiers 5-2 
Array modifier 4-5, 4-16 
Array type 4-5 
Ajray types 4-16 

Array types, multidimensional 4-17 

Array types, storage of 4-17 

Array variables, storage of 4-17 

Arrays, initialization 4-32 

Arrays, multidimensional 4-17 

Arrays, multidimensional, references to 5-5 

Arrays, storage 5-5 

asm A-l 

Assignment conversions 5-29 
Assignment expressions 5-7 
Assignment operators 5-22 
Assignment operators, compound 5-24 
Assignment operators, listed 2-5 
Assignment operators, simple (=) 5-23 
Assignments 5-1 
Associativity of operators 5-25 
Associativity, modifiers 4-6 
Asterisk (*), as pointer modifier 4-5 
Asterisk (*), in declarations 4-18 
auto storage class specifier 4-22 
auto storage class specifier, with internal 
variables 4-26 

auto variables, initialization 4-29 


B 


Backslash (\) character 2-3, 2-4 

Binary expressions 5-7 

Binary operators 5-9 

Bitfields 4-13, A-2 

Bitfields, unnamed 4-13 

Bitwise AND operator (&) 5-18 

Bitwise complement (~) operator 5-10 

Bitwise exclusive OR operator (-) 5-18 

Bitwise inclusive OR operator (|) 5-18 

Bitwise operators 5-18 

Block, defined 3-6 

Body, function 7-6 

Braces ({}), in initialization 4-30 

Brackets ([ ]) in subscript expressions 5-3 

Brackets ([ ]), as array modifier 4-5 

Brackets ([ ]), in array declarations 4-16 

Branch statements, if 6-9 

Branch statements, switch 6-14, A-2 

Break keyword 6-2 

Break statement 6-2 

Byte, size of A-2 


c 


C character set 2-1 
Calls 7-1, 7-9 

Calls with variable number of arguments 7-13 
Calls, indirect 7-9 
Calls, recursive 7-15 
Function calls 5-3 
Case constant expression 6-14 
Case keyword 6-14 
Case labels 6-14 

Case, significance of 2-2, 2-10, 2-11 
Casts 

Type-casts 5-1 
char type 4-1, A-l 
char type, range of values 4-3 
char type, storage 4-3 
Character constants 2-8, A-l, A-l 
Character set, C 2-1 
Character set, representable 2-1 
Character sets 2-1 
Character types 
Integral types 

Characters, backslash (\) 2-3, 2-4 
Characters, continuation (\) 2-4 
Characters, escape sequence 2-3 
Characters, hexadecimal escape sequence 2-3, 
A-l 

Characters, nongraphic escape sequence 2-3 
Characters, octal escape sequence 2-3 
Characters, punctuation 2-2 
Characters, special 2-2 
Characters, whitespace 2-2 
Characters, whitespace escape sequence 2-3 
Comma (,), in arg-type-list 4-20 
Comma operator 

Sequential evaluation operator 5-20 
Command line arguments 3-5 
Comments 2-12 

Compilation, conditional 8-7, 8-11 
Compilation, suppressing 8-7, 8-11 
Complement operators 5-10 
Complex declarators 4-5 
Complex declarators, interpreting 4-6 
Compound assignment operators 5-24 
Compound statement 6-3 
Compound statement, labeling 6-3 
Conditional compilation 8-7, 8-11 
Conditional operator (? :) 5-21 
Conditional statements, if 6-9 
Conditional statements, switch 6-14, A-2 
const A-l 

Constant expression, case 6-14 
Constant expression, in switch statement 6-14 
Constant expressions, defined (identifier) 8-9 
Constant expressions, in directives 8-9 
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Constant expressions, in preprocessor 
directives 8-9 

Constant expressions, restricted 8-9 
Constant-expressions 5-1, 5-8 
Constant-expressions, as initializers 5-9 
Constant- expressions, in preprocessor 
directives 5-9 
Constants 5-1, B-2 
Constants, character 2-8, A-l, A-l 
Constants, decimal integer 2-6 
Constants, defined 2-6 
Constants, enumeration, naming class 3-9 
Constants, floating-point 2-7 
Constants, floating-point, negative 2-7 
Constants, hexadecimal integer 2-6 
Constants, integer 2-6 
Constants, integer, hexadecimal A-l 
Constants, integer, long 2-7 
Constants, integer, negative 2-6 
Constants, integer, octal A-l 
Constants, integer, unsigned A-l 
Constants, manifest 8-1 
Constants, octal integer 2-6 
Constants, string 2-9 
Continuation character (\) 2-4 
Continue keyword 6-4 
Continue statement 6-4 
Conversion, actual arguments 7-12 
Conversion, formal parameters 7-12 
Conversions 5-29 

Conversions from enumeration types 5-34 
Conversions from floating-point types 5-33 
Conversions from pointer types 5-34 
Conversions, assignment 5-29 
Conversions, from signed integer types 5-29 
Conversions, from unsigned integer types 5-31 
Conversions, function call 7-12 
Conversions, function-call 5-35 
Conversions, operator 5-34 
Conversions, type-cast 5-34 
Conversions, usual arithmetic A-2 
type conversions 5-1 
Usual arithmetic conversions 5-9 


D 


Data definitions, syntax B-ll 
Data types 
Types 

Decimal integer constants 2-6 
Declarations 3-1 

Declarations, external 4-23, 4-23, 4-28 
Declarations, form of 4-1 
Declarations, formal parameters 7-4 
Declarations, forward 7-7 
Function declarations 7-7 
Declarations, function 3-1, 4-20, 7-1, 7-7, 


Index 


A-2 

Declarations, function, storage class 4-28 
Declarations, function, with variable number 
of arguments 4-20 
Declarations, internal 4-23, 4-26 
Declarations, pointer 4-18 
Declarations, syntax B-7 
Declarations, type 4-32, 4-32 
Declarations, type, typedef 4-32 
Declarations, typedef 4-32, 4-33 
Declarations, variable 3-1, 4-9 
Declarations, variable, enum 4-10 
Declarations, variable, multidimensional arrays 
4-17 

Declarations, variable, simple 4-10 
Declarations, variable, structure 4-12 
Declarations, variable, union 4-15 
Declarations, variables, array 4-16 
Declarator, abstract 4-35 
Declarators 4-5 
Declarators, complex 4-5 
Declarators, in parentheses 4-6 
Decrement operator ( — ) 5-23 
Default keyword 6-14 
Default labels 6-14 

Default storage class, internal variable 
declarations 4-26 
Define directive 8-2 

defined {identifier) constant expression 8-9 

Defining filename 8-12 

Defining line numbers 8-12 

Defining macros 8-2 

Defining manifest constants 8-2 

Definitions 3-1 

Definitions, function 3-1, 7-1, 7-1 
Function definitions 7-2 
Definitions, syntax B-ll 
Definitions, variable 3-1, 4-23 
Differences A-l 
Digits 2-1 
Dimensions 

Multidimensional arrays 4-17 
Directives 3-1, 8-1, A-2 
Directives, #define 8-2 
Directives, #elif 8-8, A-3 
Directives, #else 8-8 
Directives, #endif 8-8 
Directives, #if 8-8, A-3 
Directives, #ifdef 8-11, A-3 
Directives, #ifndef 8-11, A-3 
Directives, #include 8-6 
Directives, #line 8-12 
Directives, #undef 8-5 
Directives, permissible constant-expressions 

Directives, syntax B-ll 
Division operator (/) 5-13 
Do keyword 6-5 
Do statement 6-5 
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Do statement, continuing execution 6-4 
Do statement, terminating execution 6-2 
Double quotation marks (”), in #include 
directives 8-6 
Double quote (”) A-l 
double type 4-1 

double type, range of values 4-3 
double type, storage 4-3 


E 


Elements, referring to 5-3 

Elif directive 8-8 

Else directive 8-8 

Else keyword 6-9 

Endif directive 8-8 

entry A-l 

enum A-l 

enum keyword 4-11 

enum type A-2 

enum type specifier 4-10, 4-32 

enum type, range of values 4-3 

enum type, storage 4-3 

enum types 4-10, 4-32 

enum-list 4-11 

Enumeration constants, naming class 3-9 
Enumeration declarations 4-10, 4-32 
Enumeration expressions 5-2 
Enumeration identifiers 5-2 
Enumeration set 4-10 
Enumeration tag 4-11 
Enumeration tags 4-32 
Enumeration tags, naming class 3-10 
enumeration types 4-1 
Enumeration types 4-10, 4-32 
Enumeration types, converting 5-34 
Enumeration types, storage of 4-11 
Enumeration variables, storage of 4-11 
envp 3-5 

Equality operator (==) 5-17 
Escape sequence, hexadecimal A-l 
Escape sequences 2-3, A-l 
Evaluation order 
order of evaluation 
Execution, starting point 3-5 
Exit from functions 6-12 
Exit from switch 6-14 
Expression list 5-3 
Expression statements 6-6 
Expressions 5-1 
Expressions in parentheses 5-8 
Expressions with operators 5-7 
Expressions, assignment 5-7 
Expressions, binary 5-7 
Expressions, constant 5-8 
Constant-expressions 5-1 
See constant expressions 8-9 


Expressions, enum 5-2 
Expressions, floating-point 5-2 
Expressions, function call 5-3 
Expressions, integral 5-2 
Expressions, lvalue 5-22 
Expressions, member selection 5-6 
Expressions, pointer 5-2 
Expressions, struct 5-2 
Expressions, subscript 5-3 
Expressions, syntax B-5 
Expressions, ternary 5-7 
Expressions, type-cast 5-8 
Expressions, unary 5-7 
Expressions, union 5-2 
extern storage class specifier 4-22 
Extern storage class specifier, in forward 
declarations 7-7 

Extern storage class specifier, in function 
declarations 7-7 

Extern storage class specifier, in function 
definitions 7-2 

extern storage class specifier, with external 
variables 4-23 

extern storage class specifier, with function 
declarations 4-28 

extern storage class specifier, with internal 
variables 4-26 

External declarations 4-23, 4-23, 4-28 
External variable declarations 4-23, 4-23 


F 


far A-l 

far keyword 4-19 
Filename, changing 8-12 
Files, include 8-6 
float type 4-1 

float type, range of values 4-3 
float type, storage 4-3 
Floating-point constants 2-7 
Floating-point constants, negative 2-7 
Floating-point expressions 5-2 
Floating-point identifiers 5-2 
Floating-point types 4-2 
Floating-point types, converting 5-33 
For keyword 6-7 
For statement 6-7 

For statement, continuing execution 6-4 
For statement, terminating execution 6-2 
Formal arguments 

Formal parameters 7-4 
Formal parameters 7-4 
Formal parameters, conversion 7-12 
Formal parameters, declaring 7-4 
Formal parameters, identifiers of 7-4 
Formal parameters, naming class 3-9 
Formal parameters, storage class 7-5 
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Formal parameters, type-checking 7-4, 7-12 
fortran A-l 

Forward declarations 7-7 
Forward declarations, extern 7-7 
Forward declarations, static 7-7 
Forward declarations, storage class specifier 
7-7 

Function declarations 
Function body 7-6 
Function call expression 5-3 
Function call type-checking 7-12 
Function calls 5-3, 7-1, 7-9 
Function calls conversions 7-12 
Function calls, indirect 7-9 
Function calls, recursive 7-15 
Function calls, with variable number of 
arguments 7-13 

Function declarations 3-1, 4-20, 7-1, 7-7, A-2 

Function declarations, extern 7-7 
Function declarations, .forward 7-7 
Function declarations, implicit 7-7 
Function declarations, static 7-7 
Function declarations, storage class 4-28 
Function declarations, storage class specifier 
7-7 

Function declarations, with variable number of 
arguments 4-20 

Function definitions 3-1, 7-1, 7-1 

Function definitions, extern 7-2 

Function definitions, return type 7-2 

Function definitions, static 7-2 

Function definitions, storage class specifier 7-2 

Function definitions, syntax B-ll 
Function identifiers 5-2 
Function modifier 4-5 
Function pointers 7-9 
Function returning type 4-5, 4-20 
Function-call conversions 5-35 
Functions 7-1 
Functions, calling 7-9 
Functions, exit from 6-12 
Functions, extern 7-2, 7-7 
Functions, main 3-5, 3-5 
Functions, naming class 3-9 
Functions, parameters 3-5 
Functions, return type 7-2 
Functions, return type, implicit 7-7 
Functions, return value 6-12, 7-6 
Functions, static 7-2, 7-7 
Functions, storage class 7-2, 7-7 
Functions, visibility 7-2, 7-7 
Fundamental types 4-1 
Fundamental types, char 4-2 
Fundamental types, character 4-2 
Fundamental types, integral 4-2 
Fundamental types, double 4-2 
Fundamental types, enum 4-2, A-2 


Fundamental types, float 4-2 
Fundamental types, floating-point 4-2 
Fundamental types, initialization 4-29 
Fundamental types, initializers 4-29, 4-30 
Fundamental types, int 4-2 
Fundamental types, integral 4-2 
Fundamental types, long 4-2 
Fundamental types, range of values 4-3 
Fundamental types, short 4-2 
Fundamental types, storage 4-3 
Fundamental types, unsigned char 4-2 
Fundamental types, unsigned int 4-2 
Fundamental types, unsigned long 4-2 
Fundamental types, unsigned short 4-2 


G 


Global lifetime 3-6, 4-22 

Global variables 3-6 

Global variables, initialization 4-29 

Global variables, references to 4-26 

Global visibility 3-6 

Goto keyword 6-8 

Goto statement 6-8 


H 


Hexadecimal escape sequence A-l 
Hexadecimal escape sequences 2-3 
Hexadecimal integer constants 2-6 
huge A-l 


i 


Identifiers 2-10, 5-2, A-l, B-l 
Identifiers, array 5-2 
Identifiers, class 3-9 
Identifiers, enum 5-2 
Identifiers, floating-point 5-2 
Identifiers, formal parameters 7-4 
Identifiers, function 5-2 
Identifiers, integral 5-2 
Identifiers, modified 4-5 
Identifiers, pointer 5-2 
Identifiers, predefined 8-12 
Identifiers, struct 5-2 
Identifiers, union 5-2 
If directive 8-8 
If keyword 6-9 
If statement 6-9 
Ifdef directive 8-11 
Ifndef directive 8-11 
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Implicit declarations, function 7-7 
Implicit function declarations 7-7 
Implicit return type 7-7 
Include directive 8-6 
Include files 8-6 
Include files, search path 8-6 
Increment operator (++) 5-23 
Indirection 5-11 
Indirection operator (*) 5-11 
Inequality operator 5-17 
Initial values 4-28, 4-29 
Initializers 4-28 
Initialization 4-28 

Initialization, aggregate types 4-29, 4-30 
Initialization, array variables 4-32 
Initialization, auto variables 4-29 
Initialization, fundamental types 4-29 
Initialization, global variables 4-29 
Initialization, initial values 4-29 
Initialization, register variables 4-29 
Initialization, restrictions 4-29 
Initialization, static variables 4-29 
Initialization, with string literals 4-32 
Initializer 4-28 
Initializers 4-29 

Initializers, constant-expressions 5-9 
Initializers, fundamental types 4-29, 4-30 
Initializers, strings 4-32 
Inserting files 8-6 
int type 4-1, A-l 
int type, range of values 4-3 
int type, storage 4-3 
Integer constants, decimal 2-6 
Integer constants, hexadecimal 2-6, A-l 
Integer constants, long 2-7 
Integer constants, negative 2-6 
Integer constants, octal 2-6, A-l 
Integer constants, unsigned A-l 
Integer types, signed, converting 5-29 
Integer types, unsigned, converting 5-31 
Integral expressions 5-2 
Integral identifiers 5-2 
Integral types 4-2 
Internal declarations 4-23, 4-26 
Internal representation 4-4 
Internal variable declarations 4-23, 4-26 
Internal variable declarations, default storage 
class 4-26 

Iterative statements, do 6-5 
Iterative statements, for 6-7 
Iterative statements, while 6-16 


K 


Kemighan, Brian W. A-0 

Keywords 2-11, A-l, A-2, B-l 

Keywords, break 6-2 

Keywords, case 6-14 

Keywords, const A-l 

Keywords, continue 6-4 

Keywords, default 6-14 

Keywords, do 6-5 

Keywords, else 6-9 

Keywords, enum 4-11, A-l, A-2 

Keywords, far 4-19, A-l 

Keywords, for 6-7 

Keywords, fortran A-l 

Keywords, goto 6-8 

Keywords, huge A-l 

Keywords, if 6-9 

Keywords, near 4-19, A-l 

Keywords, pascal A-l 

Keywords, return 6-12 

Keywords, sizeof 5-12 

Keywords, struct 4-12 

Keywords, unsigned A-2 

Keywords, void 4-20, 4-21, 7-12, A-l, A-2 

Keywords, void, in argument type list 4-21 

Keywords, while 6-5, 6-16 


L 


Labeled statements 6-8 

Labels 6-8 

Labels, case 6-14 

Labels, default 6-14 

Labels, naming class 3-10 

Left shift (<<) operator 5-16 

Letters 2-1 

Lifetime, defined 3-6 

Lifetime, global 3-6, 4-22 

Lifetime, local 3-6, 4-22 

Line control 8-12 

Line directive 8-12 

Line numbers, changing 8-12 

Linked lists 4-13 

Lists, linked 4-13 

Local lifetime 3-6, 4-22 

Local variables 3-6 

Logical AND operator (&&) 5-19 

Logical NOT operator (!) 5-11 

Logical operators 5-19 

Logical operators, order of evaluation 5-19 

Logical OR operator (||) 5-20 

long type 4-1, A-l 
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long type, range of values 4-3 
long type, storage 4-3 
Loops, do statement 6-5 
Loops, for statement 6-7 
Loops, while statement 6-16 
Lvalue expressions 5-22 


M 


Macros 8-1 

Macros, parentheses in 8-5 

Macros, removing 8-5 

Macros, side effects 8-4 

Main function 3-5 

Main function, parameters 3-5 

Manifest constants 8-1 

Manifest constants, removing 8-5 

Maximum value 4-4 

Member selection expressions 5-6 

Member selection operators (->) A-3 

Member, structure 4-12 

member-declaration-list 4-12, 4-32 

Members, bitfields 4-13 

Members, naming class 3-10 

Members, referring to 5-6 

Minimum value 4-4 

Modifier, array 4-16 

Modifier, pointer 4-18 

Modifiers 4-5 

Modifiers, associativity 4-6 

Modifiers, precedence 4-6 

Multidimensional arrays 4-17 

Multidimensional arrays, references to 5-5 

Multiplication operator (*) 5-13 

Multiplicative operators 5-13 


N 


Names, type 4-34 
Identifiers 
Naming classes 3-9 
Naming classes, structures A-2 
Naming classes, unions A-2 
near A-l 

near keyword 4-19 

Nested visibility 3-7 

Nongraphic escape sequences 2-3, A-l 

Notational conventions 1-3 

Null statement 6-11 

Number sign (#) character 8-1 


o 


Octal escape sequences 2-3 
Octal integer constants 2-6 
Operands 5-1 
Operator conversions 5-34 
Operator, address-of (&) 5-11 
Operator, bitwise exclusive OR (-) 5-18 
Operator, bitwise inclusive OR (|) 5-18 
Operator, left shift (<<) 5-16 
Operator, right shift (>) 5-16 
Operator, sizeof 5-12 
Operators 5-7, 5-9, B-4 
Operators, addition (+) 5-14 
Operators, additive 5-14 
Operators, arithmetic negation (-) 5-10 
Operators, assignment 5-22 
Operators, associativity 5-25 
Operators, binary 5-9 
Operators, bitwise 5-18 
Operators, bitwise AND (&) 5-18 
Operators, bitwise complement (~) 5-10 
Operators, complement 5-10 
Operators, compound assignment 5-24 
Operators, conditional (? :) 5-21 
Operators, decrement ( — ) 5-23 
Operators, division (/) 5-13 
Operators, equality (==) 5-17 
Operators, increment (++) 5-23 
Operators, indirection (*) 5-11 
Operators, inequality (!=) 5-17 
Operators, listed 2-4 
Operators, logical 5-19 
Operators, logical AND (&&) 5-19 
Operators, logical not (!) 5-11 
Operators, logical OR (||) 5-20 
Operators, logical, order of evaluation 5-19 
Operators, member selection (->) A-3 
Operators, multiplication (*) 5-13 
Operators, multiplicative 5-13 
Operators, precedence 5-25 
Operators, relational 5-17 
Operators, relational (<) 5-17 
Operators, relational (<=) 5-17 
(>=) 5-17 

Operators, remainder (%) 5-13 
Operators, sequential evaluation (,) 5-20 
Operators, shift 5-16 
Operators, simple assignment (=) 5-23 
Operators, subtraction (-) 5-14 
Operators, ternary 5-9 
Operators, ternary (? :) 5-21 
Operators, unary 5-9 
OR operator, bitwise exclusive (-) 5-18 
OR operator, bitwise inclusive (|) 5-18 
OR operator, logical (||) 5-20 
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Order of evaluation 5-1, 5-27 

Order of evaluation, logical operators 5-19 

Overview 1-1 


p 


Parameters, argc 3-5 
Parameters, argv 3-5 
Parameters, conversion 7-12 
Parameters, formal 7-4 
Parameters, formal, declaring 7-4 
Parameters, formal, identifiers of 7-4 
Parameters, formal, naming class 3-9 
Parameters, formal, storage class 7-5 
Parameters, formal, type-checking 7-4 
Formal parameters 7-12 
Parameters, to main function 3-5 
Parameters, type-checking 7-12 
Parentheses, as function modifier 4-5 
Parentheses, in complex declarators 4-6 
Parentheses, in expressions 5-8 
Parentheses, in function call expressions 5-3 
Parentheses, in macros 8-5 
pascal A-l 

Passing by reference 7-9, 7-11 
Passing by value 7-11 

Period (.) in member selection expressions 5-6 
Pointer arithmetic 5-15 
Pointer declarations 4-18 
Pointer expressions 5-2 
Pointer identifiers 5-2 
Pointer modifier 4-5, 4-18 
Pointer type 4-5 
Pointer types 4-18 
Pointer types, converting 5-34 
Pointer types, storage 4-19 
Pointer variables, storage 4-19 
Pointer, subtracting 5-15 
Pointers, adding 5-15 
Pointers, function 7-9 
Pound sign (#) A-2 
Pound sign (#) character 
Number sign character 8-1 
Precedence 5-1 
Precedence of operators 5-25 
Precedence, of modifiers 4-6 
Predefined identifiers 8-12 
Preprocessor directives 
Directives 8-1 
Program execution 3-5 
Program structure 3-1, 3-1 
Punctuation characters 2-2 


Q 


Quotation marks 
Double quotation mark (”) 8-6 


R 


Range of values 4-4 
Range of values, char 4-3 
Range of values, double 4-3 
Range of values, enum 4-3 
Range of values, float 4-3 
Range of values, int 4-3 
Range of values, long 4-3 
Range of values, short 4-3 
Range of values, unsigned char 4-3 
Range of values, unsigned int 4-3 
Range of values, unsigned long 4-3 
Range of values, unsigned short 4-3 
Range of values, void 4-3 
Recursion 7-15 

References to global variables 4-26 
register storage class specifier 4-22 
register storage class specifier, with internal 
variables 4-26 

register variables, initialization 4-29 
Relational operators 5-17 
Relational operators (<) 5-17 
Relational operators (<=) 5-17 
(>=) 5-17 

Remainder operator (%) 5-13 
Removing macro definitions 8-5 
Removing manifest constant definitions 8-5 
Representable character set 2-1 
Representation, internal 4-4 
Reserved words 
Keywords 2-11 

Restricted -constant-expression, defined 
(i identifier ) 8-9 

Restricted-constant-expressions 5-9 
Restricted-constant-expressions, in directives 
8-9 

Return keyword 6-12 

Return statement 6-12 

Return type 4-21 

Return type, declaring 7-7 

Return type, implicit 7-7 

Return type, in function definitions 7-2 

Return value 6-12, 7-6 

Return value, structures A-3 

Returning control 6-12 

Right shift (>) operator 5-16 

Ritchie, Dennis M. A-0 
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Search path, include files 8-6 
Selection statements, if 6-9 
Selection statements, switch 6-14 
Separators B-5 

Sequential evaluation operator (,) 5-20 

Shift operators 5-16 

short type 4-1, A-l 

short type, range of values 4-3 

short type, storage 4-3 

Side effects 5-1, 5-28 

Side effects, in macros 8-4 

Signed integer types, converting 5-29 

Simple assignment operator (=) 5-23 

Simple variable declarations 4-10 

Sizeof 5-12 

Sizeof keyword 5-12 

Sizeof operator 5-12 

Source files 3-2 

Source program, constituents 3-1 
Special characters 2-2 
Specifiers, type 4-1 
Statement body 6-1 
Statement body, compound 6-3 
Statement labels 6-8 
Statement labels, naming class 3-10 
Statements 6-1 
Statements, break 6-2 
Statements, compound 6-3 
Statements, continue 6-4 
Statements, do 6-5 
Statements, expression 6-6 
Statements, for 6-7 
Statements, goto 6-8 
Statements, if 6-9 
Statements, labeled 6-8 
Statements, null 6-11 
Statements, return 6-12 
Statements, switch 6-14, A-2 
Statements, syntax B-10 
Statements, while 6-16 
static storage class specifier 4-22 
Static storage class specifier, in forward 
declarations 7-7 

Static storage class specifier, in function 
declarations 7-7 

Static storage class specifier, in function 
definitions 7-2 

static storage class specifier, with external 
variables 4-23 

static storage class specifier, with function 
declarations 4-28 

static storage class specifier, with internal 
variables 4-26 

static variables, initialization 4-29 
Storage class specifiers 4-22 
Storage class specifiers, auto 4-22 


Storage class specifiers, auto, with internal 
variables 4-26 

Storage class specifiers, extern 4-22 
Storage class specifiers, extern, with external 
variables 4-23 

Storage class specifiers, extern, with function 
declarations 4-28 

Storage class specifiers, extern, with internal 
variables 4-26 

Storage class specifiers, formal parameters 7-5 
Storage class specifiers, in forward declarations 
7-7 

Storage class specifiers, in function 
declarations 7-7 

Storage class specifiers, in function definitions 
7-2 

Storage class specifiers, register 4-22 
Storage class specifiers, register, with internal 
variables 4-26 

Storage class specifiers, static 4-22 
Storage class specifiers, static, with external 
variables 4-23 

Storage class specifiers, static, with function 
declarations 4-28 

Storage class specifiers, static, with internal 
variables 4-26 

Storage class, default, internal variable 
declarations 4-26 

Storage class, in forward declarations 7-7 

Storage class, in function declarations 7-7 

Storage class, of functions 7-2 

Storage classes 4-22 

Storage, arrays 4-17, 5-5 

Storage, char 4-3 

Storage, double 4-3 

Storage, enum 4-3 

Storage, enumeration variables 4-11 

Storage, float 4-3 

Storage, global 4-22 

Storage, int 4-3 

Storage, local 4-22 

Storage, long 4-3 

Storage, pointers 4-19 

Storage, short 4-3 

Storage, structure variables 4-14 

Storage, union variables 4-15 

Storage, unsigned char 4-3 

Storage, unsigned int 4-3 

Storage, unsigned long 4-3 

Storage j unsigned short 4-3 

Storage, void 4-3 

String initializers 4-32 

String literals 2-9 

String literals, as initializers 4-32 

Strings 5-2 

struct keyword 4-12 

struct type specifier 4-12, 4-32 

struct types 4-12, 4-32 

Structure declarations 4-12 


1-9 



Index 


Structure expressions 5-2 

Structure identifiers 5-2 

Structure member, bitfield 4-13 

Structure members 4-12 

Structure members, naming class 3-10 

Structure members, referring to 5-6 

Structure tag 4-13 

Structure tags 4-32 

Structure tags, naming class 3-10 

Structure types 4-12, 4-32 

Structure types, storage of 4-14 

Structure variables, storage of 4-14 

Structures, assignment of A-2, A-3 

Structures, passing A-3 

Structures, returning A-3 

Subscript expressions 5-3 

Subtraction operator (-) 5-14 

Subtraction, with pointers 5-15 

Switch expression 6-14 

Switch statement 6-14, A-2 

Switch statement, exit from 6-14 

Switch statement, terminating execution 6-2 

Syntax summary, declarations B-7 

Syntax summary, definitions B-ll 

Syntax summary, directives B-ll 

Syntax summary, expressions B-5 

Syntax summary, statements B-10 

Syntax summary, tokens B-l 


T 


Tags, enumeration 4-11, 4-32 

Tags, naming class 3-10 

Tags, structure 4-13, 4-32 

Tags, union 4-32 

Ternary expressions 5-7 

Ternary operator 5-9 

Ternary operator (? :) 5-21 

Tokens 2-12, B-l 

Transfer statements, break 6-2 

Transfer statements, continue 6-4 

Transfer statements, goto 6-8 

Transfer statements, labeled statements 6-8 

Two’s complement operator 5-10 

Type conversions 5-1 

Type declarations 4-32, 4-32 

Type declarations, typedef 4-32 

Type names 4-34 

Type names, in arg-type-list 4-21 

Type names, in function declarations 4-21 

Type names, void 7-12 

Type specifier, enum 4-32 

Type specifier, struct 4-12, 4-32 

Type specifier, union 4-32 

Type specifier, unsigned A-2 

Type specifier, void A-2 

Type specifiers 4-1 
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Type specifiers, abbreviations 4-3 

Type specifiers, char 4-1, A-l 

Type specifiers, double 4-1 

Type specifiers, enum 4-1, 4-10, A-2 

Type specifiers, float 4-1 

Type specifiers, int 4-1, A-l 

Type specifiers, long 4-1, A-l 

Type specifiers, short 4-1, A-l 

Type specifiers, union 4-15 

Type specifiers, unsigned char 4-1, A-l, A-2 

Type specifiers, unsigned int 4-1 

Type specifiers, unsigned long 4-1, A-l, A-2 

Type specifiers, unsigned long int A-2 

Type specifiers, unsigned short 4-1, A-2 

Type specifiers, unsigned short int A-2 

Type specifiers, void 4-1 

Type-cast conversions 5-34 

Type-cast expressions 5-8 

Type-casts 5-1 

Type-checking 7-12 

Type-checking, actual arguments 7-12 

Type-checking, argument 4-21 

Type-checking, formal parameters 7-12 

typedef declarations 4-32 

Typedef declarations 4-33 

Typedef names, naming class 3-10 

Typedef types 4-33 

Types, aggregate 4-1 

Types, aggregate, initialization 4-29, 4-30 
Types, array 4-5, 4-16 
Types, array, initialization 4-32 
Types, array, multidimensional 4-17 
Types, array, storage of 4-17 
Types, char 4-1, A-l 
Types, char, storage 4-3, 4-3 
Types, character 
Types, integral 
Types, defining 4-32 
Types, double 4-1 
Types, double, range of values 4-3 
Types, double, storage 4-3 
Types, enum 4-10, 4-32, A-2 
Types, enum, range of values 4-3 
Types, enum, storage 4-3 
Types, enumeration 4-1, 4-10, 4-32 
Types, enumeration, storage of 4-11 
Types, float 4-1 

Types, float, range of values 4-3 

Types, float, storage 4-3 

Types, floating-point 4-2 

Types, function returning 4-5, 4-20 

Types, fundamental 4-1 

Types, fundamental, initialization 4-29 

Types, fundamental, initializers 4-29, 4-30 

Types, fundamental, range of values 4-3 

Types, fundamental, storage 4-3 

Types, int 4-1, A-l 

Types, int, range of values 4-3 

Types, int, storage 4-3 
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Types, integral 4-2 

Types, long 4-1, A-l 

Types, long, range of values 4-3 

Types, long, storage 4-3 

Types, names of 4-34 

Types, pointer 4-5, 4-18 

Types, pointer, storage 4-19 

Types, short 4-1, A-l 

Types, short, range of values 4-3 

Types, short, storage 4-3 

Types, struct 4-12, 4-32 

Types, structure 4-12, 4-32 

Types, structure, storage of 4-14 

Types, typedef 4-33 

Types, union 4-15, 4-32 

Types, union, storage 4-15 

Types, unsigned A-2 

Types, unsigned char 4-1, A-l, A-2 

Types, unsigned char, range of values 4-3 

Types, unsigned char, storage 4-3 

Types, unsigned int 4-1 

Types, unsigned int, range of values 4-3 

Types, unsigned int, storage 4-3 

Types, unsigned long 4-1, A-l, A-2 

Types, unsigned long int A-2 

Types, unsigned long, range of values 4-3 

Types, unsigned long, storage 4-3 

Types, unsigned short 4-1, A-2 

Types, unsigned short int A-2 

Types, unsigned short, range of values 4-3 

Types, unsigned short, storage 4-3 

Types, user-defined 4-32 

Types, void A-2 

Types, void, range of values 4-3 

Types, void, storage 4-3 


u 


Unary expressions 5-7 

Unary operators 5-9 

Undefine directive 8-5 

Union declarations 4-15, 4-32 

Union expression 5-2 

Union identifiers 5-2 

Union members, naming class 3-10 

Union members, referring to 5-6 

Union tags 4-32 

Union tags, naming class 3-10 

union type 4-15 

union type specifier 4-15, 4-32 

Union types 4-32 

union types 4-32 

Union types, storage 4-15 

Union variables, storage 4-15 

unsigned char type 4-1, A-l, A-2 

unsigned char type, range of values 4-3 

unsigned char type, storage 4-3 


unsigned int type 4-1 

unsigned int type, range of values 4-3 

unsigned int type, storage 4-3 

Unsigned integer types, converting 5-31 

unsigned keyword A-2 

unsigned long A-2 

unsigned long int A-2 

unsigned long type 4-1, A-l 

unsigned long type, range of values 4-3 

unsigned long type, storage 4-3 

unsigned short A-2 

unsigned short int A-2 

unsigned short type 4-1 

unsigned short type, range of values 4-3 

unsigned short type, storage 4-3 

unsigned type A-2 

User-defined types 4-32 

Usual arithmetic conversions 5-9, A-2 


v 


Values, maximum 4-4 
Values, minimum 4-4 
Values, range 4-4 
Variable declarations 3-1, 4-9 
Variable declarations, array 4-16 
Variable declarations, enum 4-10 
Variable declarations, external 4-23, 4-23 
Variable declarations, internal 4-23, 4-26 
Variable declarations, internal, default storage 
class 4-26 

Variable declarations, pointer 4-18 
Variable declarations, simple 4-10 
Variable declarations, structure 4-12 
Variable declarations, union 4-15, 4-15 
Variable definitions 3-1, 4-23 
Variable names 
Identifiers 

Variables, array, initialization 4-32 
Variables, array, storage of 4-17 
Variables, auto, initialization 4-29 
Variables, enumeration, storage of 4-11 
Variables, global 3-6 
Variables, global, initialization 4-29 
Variables, global, references to 4-26 
Variables, local 3-6 
Variables, naming class 3-9 
Variables, pointer, storage 4-19 
Variables, register, initialization 4-29 
Variables, static, initialization 4-29 
Variables, structure, storage of 4-14 
Variables, union, storage 4-15 
Vertical tab (VT) A-l 
Visibility, defined 3-6 
Visibility, global 3-6 
Visibility, nested 3-7 
Visibility, of functions 7-2, 7-7 
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void A-l 

void * construction 4-21 

void keyword 4-21 

void keyword, as arg-type-list 4-20 

void keyword, as type name 7-12 

void keyword, in argument type list 4-21 

void keyword, in function return type 4-21 

void type A-2 

void type, range of values 4-3 
void type, storage 4-3 
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While keyword 6-5, 6-16 

While statement 6-16 

While statement, continuing execution 6-4 

While statement, terminating execution 6-2 

Whitespace characters 2-2 

Whitespace escape sequences 2-3, A-l 


1-12 




5-1-86 

SCO-514-210-033 



NOTES 



NOTES 



